MCP HubMCP Hub
haltakov

meme-mcp

by: haltakov

A simple Model Context Protocol (MCP) server for generating memes using the ImgFlip API

23created 07/03/2025
Visit
meme
API

📌Overview

Purpose: To provide a simple Model Context Protocol (MCP) server that generates memes using the ImgFlip API, allowing AI models and tools to create meme images from user prompts.

Overview: The Meme MCP Server facilitates meme generation by implementing a single tool called generateMeme, which makes it easy for developers to integrate meme creation into their applications through a straightforward configuration process.

Key Features:

  • Meme Generation Tool: The generateMeme tool allows users to specify parameters like templateNumericId, text0, and text1 to create customized memes based on selected templates.

  • Easy Configuration: Users can quickly set up the server in their client applications using the meme-mcp NPM package, which includes environment variable settings for ImgFlip API credentials, ensuring seamless integration.


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.

Tools

The server implements 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). 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. Your configuration should then 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, 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.

Author

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