Meme

Serves meme generation via ImgFlip using a single generateMeme tool and MCP client integration.

javascript

41

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "haltakov-meme-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "meme-mcp"
      ],
      "env": {
        "IMGFLIP_PASSWORD": "<IMGFLIP PASSWORD>",
        "IMGFLIP_USERNAME": "<IMGFLIP USERNAME>"
      }
    }
  }
}

You can run a Meme MCP Server that uses ImgFlip to generate meme images from prompts. It exposes a single tool, generateMeme, so AI models and tools can request meme images by choosing a template and inserting two text captions. This makes it easy to automate meme creation in conversations, assistants, or workflows.

How to use

Configure a client to connect to the Meme MCP Server as a local stdio service. You will typically start the server via a package runner and then invoke the generateMeme tool with a template id and two caption strings. Your client will pass requests to the tool and receive the generated meme image data in response.

How to install

Prerequisites you need before installing:
- Node.js (with npm) installed on your system
- Access to the internet to install packages
- An ImgFlip account to provide credentials for meme generation

Option A: Use npx to run meme-mcp directly without a global install
- Ensure Node.js is installed
- Run the following to connect through the Meme MCP Server using npx (the config example assumes you will provide ImgFlip credentials later):

{
  "mcpServers": {
    "meme": {
      "command": "npx",
      "args": ["-y", "meme-mcp"],
      "env": {
        "IMGFLIP_USERNAME": "<IMGFLIP USERNAME>",
        "IMGFLIP_PASSWORD": "<IMGFLIP PASSWORD>"
      }
    }
  }
}

Additional setup and troubleshooting

If you encounter trouble locating the correct npx version (for example when using NVM), you can install the meme-mcp package globally and run it directly. This ensures you have a stable entry point for the MCP server.

npm install -g meme-mcp

If you want to point the client to a specific node executable and node module path, you can provide an explicit runtime path in your config as shown here. Replace <USERNAME> with your user name and adjust paths to match your environment.

{
  "mcpServers": {
    "meme": {
      "command": "/Users/<USERNAME>/.nvm/versions/node/v20.18.2/bin/node",
      "args": ["/Users/<USERNAME>/.nvm/versions/node/v20.18.2/lib/node_modules/meme-mcp/dist/index.js"],
      "env": {
        "IMGFLIP_USERNAME": "<IMGFLIP USERNAME>",
        "IMGFLIP_PASSWORD": "<IMGFLIP PASSWORD>"
      }
    }
  }
}

Examples you can run after setup

Once the Meme MCP Server is configured, you can start asking it to generate memes by providing a template id and two text captions. For example, you can request a meme with a specific meme template and your two lines of caption text, and the server will return the generated image.

Available tools

generateMeme

Generates a meme image using a numeric template ID and two caption texts. Accepts parameters templateNumericId, text0, and text1 to construct the meme.