MeiGen AI Design MCP 
开源 MCP 服务器 — 把 AI 图像和视频生成原生接入到你的 AI 编程工具
支持 9 个主流模型(GPT Image 2 · Nanobanana 2 · Seedream 5.0 · Midjourney V8.1 · Flux 2 Klein · Seedance 2.0 · Happyhorse 1.0 · Veo 3.1 · 本地 ComfyUI),内置 1,446 条精选提示词,支持并行子 Agent 编排和独立 CLI 模式。可用于 Claude Code、Cursor、Codex、Windsurf、Roo Code、OpenClaw、Hermes Agent 及任意 MCP 兼容客户端。
快速开始 •
演示 •
功能 •
后端 •
命令
English | 中文
---
## 这是什么？
一个开源 MCP 服务器,把任何 AI 编程工具变成专业设计助理。**8 个工具** + 1,446 条精选提示词库,让它能设计 logo、做产品图、把静态图动画化成视频,以及并行编排多个方向的批量生成。支持 **Claude Code**、**Cursor**、**Codex**、**Windsurf**、**Roo Code**、**OpenClaw**、**Hermes Agent** 以及任意 MCP 兼容客户端 — 后端可选 **MeiGen 平台**、任意 **OpenAI 兼容 API** 或你的 **本地 ComfyUI**。
- 三种后端模式:**MeiGen 云端**(9 个图像与视频模型)、**OpenAI 兼容**(自带 key 和端点)、**本地 ComfyUI**(离线,你的 GPU)
- 内置 1,446 条精选提示词(来自 [nanobanana-trending-prompts](https://github.com/jau123/nanobanana-trending-prompts))+ 风格感知的提示词增强
- 通过子 Agent 实现并行批量生成,主对话上下文保持干净 — 同时提供独立 CLI 模式,适合 shell 脚本和 CI 流水线
---
## 实际效果
▶ 在 YouTube 观看演示
### 产品图 — 4 个方向并行生成
> *"帮这瓶香水做 4 张产品展示图，其中一张要有模特。"*
**过程** — AI 自动上传参考图、规划 4 个创意方向、撰写专业提示词：
**结果** — 不到 2 分钟，4 个方向全部完成：
**生成的图片：**
---
## 快速开始
### Claude Code 插件（推荐）
```bash
# 添加插件源
/plugin marketplace add jau123/MeiGen-AI-Design-MCP
# 安装
/plugin install meigen@meigen-marketplace
```
**安装完成后重启 Claude Code**（关闭再打开，或新建终端标签页）。
**其他插件市场** — 也可通过 [wshobson/agents](https://github.com/wshobson/agents)（30k+ stars）安装：
```bash
/plugin marketplace add wshobson/agents
/plugin install meigen-ai-design@claude-code-workflows
```
> 该市场不包含 MCP 服务配置。安装后需手动添加到项目 `.mcp.json`：
> ```json
> { "mcpServers": { "meigen": { "command": "npx", "args": ["-y", "meigen@1.3.2"] } } }
> ```
#### 首次配置
重启后，免费功能无需配置即可使用 — 试试问：
> "帮我搜索一些创意灵感"
如需解锁图片生成，运行配置向导：
```
/meigen:setup
```
向导会引导你完成：
1. **选择后端** — 本地 ComfyUI、MeiGen 云端、或任意 OpenAI 兼容 API（自带 Key 和端点）
2. **输入凭证** — ComfyUI 地址、API Token 或 Key
3. **完成** — 再次重启 Claude Code，即可开始生图
### Cursor / VS Code / Windsurf / Roo Code
一行命令为任意支持的 AI 编程工具配置 MeiGen：
```bash
npx meigen init cursor # Cursor
npx meigen init vscode # VS Code / GitHub Copilot
npx meigen init windsurf # Windsurf
npx meigen init roo # Roo Code
npx meigen init claude # Claude Code（项目级）
```
自动写入正确格式的 MCP 配置文件。如果配置文件已存在，MeiGen 会合并写入，不会覆盖你的其他 MCP 服务。
### OpenClaw
从 [ClawHub](https://clawhub.ai/plugins/meigen-ai-design) 安装完整插件（包含命令、技能和 MCP 服务）：
```bash
openclaw bundles install clawhub:meigen-ai-design
```
或仅安装技能（不含命令/agents）：
```bash
npx clawhub@latest install creative-toolkit
```
### CLI 模式(不需要 MCP 宿主)
如果你想在 shell 脚本、CI 流水线或终端中直接用 AI 生图,MeiGen 同一个 npm 包里自带一个 `gen` 命令。
```bash
# 设置 token(在 https://www.meigen.ai → 设置 → API Keys 获取)
export MEIGEN_API_TOKEN=meigen_sk_...
# 生图
npx meigen gen --prompt "阳光厨房里的三花猫"
# 指定模型 + 比例
npx meigen gen -p "科技 logo" -m midjourney-v8.1 -r 1:1
# 带参考图(本地路径自动上传)
npx meigen gen -p "产品 hero shot" --ref ~/Desktop/bottle.jpg
# 只提交不等待 — 输出 generationId(适合 CI)
npx meigen gen -p "..." --no-wait
# JSON 输出(适合 jq 管道)
npx meigen gen -p "..." --json | jq -r '.imageUrls[0]'
```
图像保存到 `~/Pictures/meigen/`(可用 `MEIGEN_OUTPUT_DIR` 覆盖)。
`meigen gen --help` 查看所有参数。
### 其他 MCP 兼容客户端
添加到 MCP 配置文件（如 `.mcp.json`、`claude_desktop_config.json`）：
```json
{
"mcpServers": {
"meigen": {
"command": "npx",
"args": ["-y", "meigen@1.3.2"],
"env": {
"MEIGEN_API_TOKEN": "meigen_sk_..."
}
}
}
}
```
> 即使没有 API Key，免费功能（灵感搜索、提示词增强、模型列表）也可以直接使用。
### Hermes Agent (NousResearch)
[Hermes Agent](https://github.com/NousResearch/hermes-agent) 原生支持 MCP — 在 `~/.hermes/config.yaml` 加上:
```yaml
mcp_servers:
meigen:
command: "npx"
args: ["-y", "meigen@1.3.2"]
env:
MEIGEN_API_TOKEN: "meigen_sk_..."
timeout: 600 # generate_video 可能 5–10 分钟,Hermes 默认 120s 会超时
connect_timeout: 120 # 首次 npx 下载可能需要一分钟
```
> `timeout: 600` 和 `connect_timeout: 120` 这两个覆盖很重要 — Hermes 默认(120s / 60s)是给短命令调好的,视频生成或首次 npx 下载会超。
---
功能一览
### MCP 工具
| 工具 | 免费 | 说明 |
|------|------|------|
| `search_gallery` | 是 | 搜索 1,446 条精选热门提示词，附带视觉预览（数据来自 [nanobanana-trending-prompts](https://github.com/jau123/nanobanana-trending-prompts)） |
| `get_inspiration` | 是 | 获取某条提示词的完整内容、所有图片和元数据 |
| `enhance_prompt` | 是 | 将简短想法转化为专业图片提示词 |
| `list_models` | 是 | 列出所有已配置后端的可用模型 |
| `comfyui_workflow` | 是 | 管理 ComfyUI 工作流模板：列表、查看、导入、修改、删除 |
| `manage_preferences` | 是 | 记住你偏好的风格、比例、模型和收藏的提示词 |
| `generate_image` | 需要 Key | 生成图片 — 自动路由到最佳可用后端。本地参考图自动压缩上传。 |
| `generate_video` | 需要 Key | 生成视频(MeiGen 后端) — Seedance 2.0 (fast/pro 双档)、Happyhorse 1.0、Veo 3.1。支持文生视频和首帧图生视频,本地文件自动上传。MP4 保存到 `~/Movies/meigen/`。 |
### 快捷命令
| 命令 | 说明 |
|------|------|
| `/meigen:gen <提示词>` | 快速生图 — 跳过对话，直接生成 |
| `/meigen:find <关键词>` | 搜索 1,446 条精选提示词获取灵感 |
| `/meigen:models` | 浏览和切换当前会话的 AI 模型 |
| `/meigen:setup` | 交互式后端配置向导 |
### 独立 CLI 模式
适合 shell 脚本、CI 流水线以及不跑 MCP 宿主的终端用户:
```bash
export MEIGEN_API_TOKEN=meigen_sk_...
npx meigen gen --prompt "阳光厨房里的三花猫"
npx meigen gen -p "logo design" -m midjourney-v8.1 -r 1:1 --json
```
完整参数见 [CLI 模式(不需要 MCP 宿主)](#cli-模式不需要-mcp-宿主) 章节。
### 智能 Agent
MeiGen 使用专用子 Agent 实现高效并行执行：
| Agent | 用途 |
|-------|------|
| `image-generator` | 在隔离上下文中执行 `generate_image` — 支持真正的并行生成 |
| `prompt-crafter` | 为批量生成撰写多个不同风格的提示词（使用 Haiku 模型，更节省成本） |
| `gallery-researcher` | 深度灵感搜索，不会占用主对话的上下文（使用 Haiku 模型） |
### 输出风格
通过 `/output-style` 切换创意模式：
- **Creative Director** — 创意总监模式，以视觉叙事、情绪板和设计思维组织回复
- **Minimal** — 极简模式，只输出图片和文件路径，无多余解释。适合批量工作流
### 自动化 Hook
- **配置检查** — 会话启动时自动验证后端配置，缺失时引导完成设置
- **自动打开** — 生成的图片自动在预览中打开（macOS）
---
生成后端
MeiGen MCP 支持三种图片生成后端，可以配置一个或多个 — 系统自动选择最佳可用后端。
### ComfyUI — 本地免费
在自己的 GPU 上运行，完全控制模型、采样器和工作流参数。支持导入任意 ComfyUI API 格式的工作流 — MeiGen 自动检测 KSampler、CLIPTextEncode、EmptyLatentImage、LoadImage 节点。
```json
{
"comfyuiUrl": "http://localhost:8188",
"comfyuiDefaultWorkflow": "txt2img"
}
```
> 适合 Flux、SDXL 或任何你本地运行的模型。图片完全不离开你的机器。
### MeiGen 云端
云端 API，支持多种模型：GPT Image 2.0、Nanobanana 2、Seedream 5.0 等。无需 GPU。
**获取 API Token：**
1. 登录 [meigen.ai](https://www.meigen.ai)
2. 点击头像 → **设置** → **API Keys**
3. 创建新 Key（以 `meigen_sk_` 开头）
```json
{ "meigenApiToken": "meigen_sk_..." }
```
**GPT Image 2.0 分辨率与质量** — 默认模型支持两个可选的 `generate_image` 参数：
- `resolution`：例如 `"1K"` / `"2K"` / `"4K"` — 海报、印刷、大屏壁纸时升级
- `quality`：例如 `"low"` / `"medium"` / `"high"` — 快速草图、缩略图可用 `"low"` 省积分
每个模型支持的分辨率和质量档不同 — 运行 `list_models` 查看各模型实际支持的档位。最新价格请查看 [meigen.ai/model-comparison](https://www.meigen.ai/model-comparison)。
### 自带 API（OpenAI 兼容）
接入**任意**符合 OpenAI 接口规范的生图 API — Together AI、Fireworks AI、DeepInfra、硅基流动，或你自己的端点。只需提供 Key、请求地址和模型名：
```json
{
"openaiApiKey": "sk-...",
"openaiBaseUrl": "https://api.together.xyz/v1",
"openaiModel": "black-forest-labs/FLUX.1-schnell"
}
```
> 三种后端都支持**参考图**。MeiGen 和 OpenAI 兼容 API 接受 URL；ComfyUI 同时支持 URL 和本地文件路径，会将参考图注入到工作流的 LoadImage 节点中。
---
## 配置
### 交互式配置（推荐）
```
/meigen:setup
```
配置向导会引导你选择后端、输入 API Key、导入 ComfyUI 工作流。你也可以直接粘贴 API 提供商文档中的 `curl` 命令 — 自动提取 Key、URL 和模型名。
### 配置文件
配置存储在 `~/.config/meigen/config.json`。ComfyUI 工作流存储在 `~/.config/meigen/workflows/`。
### 环境变量
环境变量优先级高于配置文件。
| 变量 | 说明 |
|------|------|
| `MEIGEN_API_TOKEN` | MeiGen 平台 Token |
| `OPENAI_API_KEY` | 你的 API Key（任意 OpenAI 兼容供应商） |
| `OPENAI_BASE_URL` | API 地址 — 修改此项以接入 Together AI、Fireworks AI 等 |
| `OPENAI_MODEL` | 端点支持的模型 ID |
| `COMFYUI_URL` | ComfyUI 服务地址（默认：`http://localhost:8188`） |
| `MEIGEN_OUTPUT_DIR` | 生成图像的本地保存目录（默认：`~/Pictures/meigen`）。沙箱环境（如 OpenClaw）无法访问默认路径时使用。 |
| `MEIGEN_VIDEO_OUTPUT_DIR` | 生成视频的本地保存目录（默认：`~/Movies/meigen`）。 |
| `XDG_PICTURES_DIR` | 仅 Linux — `MEIGEN_OUTPUT_DIR` 未设时,图像保存到 `$XDG_PICTURES_DIR/meigen`(由桌面环境设置)。未设时回退 `~/Pictures/meigen`。 |
| `XDG_VIDEOS_DIR` | 仅 Linux — 同 `XDG_PICTURES_DIR` 但对视频生效,回退 `~/Movies/meigen`。 |
---
## 隐私
MeiGen MCP 尊重你的隐私。以下是数据处理方式：
- **ComfyUI（本地）** — 所有处理在本机完成，不发送任何数据到外部。
- **MeiGen 云端** — 提示词和参考图会发送到 `api.meigen.ai` 进行生成。生成的图片临时存储在 Cloudflare R2。详见 [meigen.ai/privacy](https://www.meigen.ai/privacy)。
- **OpenAI 兼容 API** — 提示词和参考图会发送到你配置的 API 端点。请参考你的服务商隐私政策。
- **参考图上传** — 图片在本地压缩（最大 2MB）后上传到 Cloudflare R2（通过 `gen.meigen.ai`），无需认证。上传图片 **24 小时后自动过期**。ComfyUI 用户可直接传本地路径,完全跳过上传。
- **灵感搜索和提示词增强** — 在本地使用内置数据运行，不调用外部 API。
不包含任何遥测、分析或追踪功能。
### 自定义存储后端
如果你希望使用自己的 S3/R2 存储桶上传参考图,设置 `UPLOAD_GATEWAY_URL` 环境变量或在 `~/.config/meigen/config.json` 中设置 `uploadGatewayUrl`,指向你自己的 presign 接口。接口需实现:
```
POST /upload/presign
Content-Type: application/json
请求: { "filename": "photo.jpg", "contentType": "image/jpeg", "size": 123456 }
响应: { "success": true, "presignedUrl": "https://...", "publicUrl": "https://..." }
```
`presignedUrl` 用于 `PUT` 上传,`publicUrl` 是返回给用户的公开可访问 URL。
---
## 许可证
[MIT](LICENSE) — 个人和商业用途均免费。