Meme MCP Server

Meme MCP Server

By haltakov GitHub

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

Overview

what is Meme MCP?

Meme MCP is a simple Model Context Protocol (MCP) server designed for generating memes using the ImgFlip API. It allows users to create meme images based on their prompts.

how to use Meme MCP?

To use Meme MCP, configure the server in your client using the meme-mcp NPM package. You need to set up your ImgFlip account credentials and follow the provided configuration examples.

key features of Meme MCP?

  • Generates memes using various templates from ImgFlip.
  • Easy integration with AI models and tools.
  • Customizable text placeholders for meme creation.

use cases of Meme MCP?

  1. Creating personalized memes for social media sharing.
  2. Integrating meme generation into chatbots or AI assistants.
  3. Fun and creative meme generation for entertainment purposes.

FAQ from Meme MCP?

  • Do I need an ImgFlip account to use Meme MCP?

Yes, you need to create a free account on ImgFlip to obtain your username and password.

  • Can I use Meme MCP without Node.js?

No, Meme MCP requires Node.js for installation and operation.

  • Is there any troubleshooting support available?

Yes, the documentation includes troubleshooting tips for common issues.

Content

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.

No tools information available.
No content found.