Meme Generator

You can create memes programmatically with a dedicated MCP server that renders images from templates and overlays custom text. This server makes it easy to generate memes on demand, supports multiple templates, and automatically wraps text to fit each image. It’s useful for automating meme generation in your workflows or chat integrations while keeping a consistent look across results.

How to use

You run the Meme Generator MCP server via an MCP client. Start the server in_stdio mode to execute locally, or connect to a remote MCP endpoint if you have one configured. Use the provided tools to inspect available memes and then generate memes by supplying the desired text for each placeholder.

How to install

Prerequisites: ensure you have Python 3.12+ installed. You also need the MCP runtime you use (for example, uv or uvx). You will run the server using the commands shown in the configuration examples.

# Local development workflow (example)
git clone https://github.com/t0ster/meme-generator-mcp.git
cd meme-generator-mcp
uv sync

Configuration and usage notes

Two standard ways to run the MCP server are shown here. Use the remote/official runtime first if you have a hosted MCP endpoint; otherwise run locally in development mode to point at local templates and configs.

# Production-style runtime (remote-like configuration)
{
  "mcpServers": {
    "meme_generator": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/t0ster/meme-generator-mcp",
        "meme-generator-mcp"
      ]
    }
  }
}

# Local development configuration (dev mode)
{
  "mcpServers": {
    "meme_generator_dev": {
      "command": "uv",
      "args": ["run", "meme-generator-mcp", "--dev"]
    }
  }
}

What you can do with it

Inspect available meme templates and their placeholders, then generate memes by providing text for each placeholder. Generated memes are saved by default to a user-specific directory, which you can customize using environment variables.

Example tools and results

The server exposes tools to query meme information and to generate memes with your chosen texts.

Troubleshooting tips

If you don’t see templates or configs in development mode, ensure you are running with the dev flag or that your local template and config paths are mounted correctly. Check the output path for generated memes and confirm it exists and is writable.

Available tools

get_meme_info

Retrieve information about available memes and their placeholder requirements.

generate_meme

Create a meme by supplying a meme type and a mapping of placeholder texts to use for the overlay.