mcpField
M
Meme MCP Server

Meme MCP Server

Local
github.com/haltakovMedia & Design58Updated 85w ago
Repository

About Meme MCP Server

Meme MCP Server is a simple MCP server that generates meme images through the ImgFlip API. It is aimed at users who want AI models or tools to create meme images from their prompts.

Key features

  1. 01Generate memes from numeric template IDs
  2. 02Fill two text placeholders per meme
  3. 03Run via the meme-mcp npm package

Use cases

  1. 01Ask Claude Desktop to generate a meme
  2. 02Let an AI assistant create memes from conversation context

MCP support

This project is an MCP server that exposes a generateMeme tool to MCP clients, which can call it to produce meme images.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "meme": {
      "command": "npx",
      "args": [
        "-y",
        "meme-mcp"
      ],
      "env": {
        "IMGFLIP_USERNAME": "<IMGFLIP_USERNAME>",
        "IMGFLIP_PASSWORD": "<IMGFLIP_PASSWORD>"
      }
    }
  }
}
Run commandnpx -y meme-mcp
Environment variables to set
IMGFLIP_USERNAME
IMGFLIP_PASSWORDSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmeme-mcp

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
templateNumericIdstringYes
text0stringYes
text1stringNo

Details

From the project README

Meme MCP Server

A simple Model Context Protocol (MCP) server for generating memes using the ImgFlip API. This server enables AI models and tools to generate meme images from user prompts.

Meme Server MCP server

Tools

The server implements the following a single tool called generateMeme.

The tool accepts the following parameters:

  • templateNumericId: The numeric ID of the meme template to use.
  • text0: The text for the first placeholder.
  • text1: The text for the second placeholder.

Usage

You can configure the meme generator server in your client using the meme-mcp NPM package. Here is an example configuration for Claude Desktop (Settings -> Developer -> Edit Config):

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

Note: you need to create a free account on ImgFlip to get your username and password.

Troubleshooting

Sometimes Claude Desktop fails to find the right version of npx (especially if you are using NVM, see this Issue for details). In this case, you can manually install meme-mcp globally and then use it directly.

npm install -g meme-mcp

You can find the path of your node executable by running which node in your terminal. After that your configuration should look like this:

{
  "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>"
      }
    }
  }
}

Example

After configuring Claude Desktop, you need to restart it and then you will see the small hammer icon on the bottom right in the chat input. You can then ask Claude to generate a meme for you.

Claude Desktop with meme server configured

Author

This project is created for fun by Vladimir Haltakov. If you find it interesting you can message me on X @haltakov.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.