# mcp-server-meigen

Python wrapper for the [MeiGen](https://github.com/jau123/MeiGen-AI-Design-MCP) AI image generation MCP server.

Turn your AI coding tool into a visual creative assistant — search 1,500+ curated prompts, enhance ideas into professional image prompts, and generate images with local ComfyUI, MeiGen Cloud, or OpenAI-compatible APIs.

## Prerequisites

- **Node.js >= 18** ([nodejs.org](https://nodejs.org))

## Usage

### With uvx (recommended)

```json
{
  "mcpServers": {
    "meigen": {
      "command": "uvx",
      "args": ["mcp-server-meigen"]
    }
  }
}
```

### With pip

```bash
pip install mcp-server-meigen
mcp-server-meigen
```

## What's included

| Tool | Free | Description |
|------|------|-------------|
| `search_gallery` | Yes | Search 1,500+ curated trending prompts |
| `get_inspiration` | Yes | Get full prompt and images for a gallery entry |
| `enhance_prompt` | Yes | Transform a brief idea into a professional prompt |
| `list_models` | Yes | List available models across providers |
| `upload_reference_image` | Yes | Compress and upload a local image as reference |
| `comfyui_workflow` | Yes | Manage ComfyUI workflow templates |
| `manage_preferences` | Yes | Save preferred style, aspect ratio, and model |
| `generate_image` | Key | Generate an image via the best available provider |

Free features work immediately — no API key needed.

## How it works

This package is a thin wrapper around the npm package [`meigen`](https://www.npmjs.com/package/meigen). It launches `npx -y meigen@latest` and relays stdio communication. All logic runs in Node.js.

## Links

- Homepage: https://www.meigen.ai
- GitHub: https://github.com/jau123/MeiGen-AI-Design-MCP
- npm: https://www.npmjs.com/package/meigen
- Demo: https://youtu.be/JQ3DZ1DXqvs

## License

MIT
