Metadata-Version: 2.4
Name: memer-mcp
Version: 0.1.0
Summary: AI meme generator — CLI tool and MCP server for Claude Code
License-Expression: MIT
Keywords: claude,cli,mcp,meme
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0
Description-Content-Type: text/markdown

# memer-mcp

AI meme generator — CLI tool and MCP server for Claude Code.

Powered by [memelord.com](https://www.memelord.com).

## Get an API key

Sign up at [memelord.com](https://www.memelord.com) and grab your API key (starts with `mlord_live_`).

## Install

```bash
pip install memer-mcp
```

## Use with Claude Code (MCP)

Add to your Claude Code MCP config (`~/.claude.json` or project `.mcp.json`):

```json
{
  "mcpServers": {
    "memer": {
      "command": "uvx",
      "args": ["memer-mcp"],
      "env": { "MEME_API": "mlord_live_YOUR_KEY_HERE" }
    }
  }
}
```

Claude will now have a `memer` tool it can use to generate memes during conversations.

## Use as a CLI

```bash
export MEME_API=mlord_live_YOUR_KEY_HERE

memer "developer fixing bugs at 3am"
memer "when the code finally compiles" --count 3
memer "monday morning meetings" --classic
memer "css centering a div" --open
```

### CLI options

| Flag | Description |
|------|-------------|
| `-n N, --count N` | Generate 1-10 memes (default: 1) |
| `--classic` | Classic meme templates only |
| `--trending` | Trending meme templates only |
| `--nsfw` | Include NSFW templates |
| `--open` | Also open in system viewer |
| `--json` | Print raw API response |

Memes are saved to `~/.memer/memes/`.
