meme-mcp
by: haltakov
A simple Model Context Protocol (MCP) server for generating memes using the ImgFlip 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 liketemplateNumericId
,text0
, andtext1
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.