meigen
v1.3.1
Published
Visual creative expert plugin — search inspiration, enhance prompts, and generate AI images with intelligent workflow orchestration
Maintainers
Readme
这是什么?
一个开源 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)+ 风格感知的提示词增强
- 通过子 Agent 实现并行批量生成,主对话上下文保持干净 — 同时提供独立 CLI 模式,适合 shell 脚本和 CI 流水线
实际效果
产品图 — 4 个方向并行生成
"帮这瓶香水做 4 张产品展示图,其中一张要有模特。"
过程 — AI 自动上传参考图、规划 4 个创意方向、撰写专业提示词:
结果 — 不到 2 分钟,4 个方向全部完成:
生成的图片:
快速开始
Claude Code 插件(推荐)
# 添加插件源
/plugin marketplace add jau123/MeiGen-AI-Design-MCP
# 安装
/plugin install meigen@meigen-marketplace安装完成后重启 Claude Code(关闭再打开,或新建终端标签页)。
其他插件市场 — 也可通过 wshobson/agents(30k+ stars)安装:
/plugin marketplace add wshobson/agents
/plugin install meigen-ai-design@claude-code-workflows该市场不包含 MCP 服务配置。安装后需手动添加到项目
.mcp.json:{ "mcpServers": { "meigen": { "command": "npx", "args": ["-y", "[email protected]"] } } }
首次配置
重启后,免费功能无需配置即可使用 — 试试问:
"帮我搜索一些创意灵感"
如需解锁图片生成,运行配置向导:
/meigen:setup向导会引导你完成:
- 选择后端 — 本地 ComfyUI、MeiGen 云端、或任意 OpenAI 兼容 API(自带 Key 和端点)
- 输入凭证 — ComfyUI 地址、API Token 或 Key
- 完成 — 再次重启 Claude Code,即可开始生图
Cursor / VS Code / Windsurf / Roo Code
一行命令为任意支持的 AI 编程工具配置 MeiGen:
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 安装完整插件(包含命令、技能和 MCP 服务):
openclaw bundles install clawhub:meigen-ai-design或仅安装技能(不含命令/agents):
npx clawhub@latest install creative-toolkitCLI 模式(不需要 MCP 宿主)
如果你想在 shell 脚本、CI 流水线或终端中直接用 AI 生图,MeiGen 同一个 npm 包里自带一个 gen 命令。
# 设置 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):
{
"mcpServers": {
"meigen": {
"command": "npx",
"args": ["-y", "[email protected]"],
"env": {
"MEIGEN_API_TOKEN": "meigen_sk_..."
}
}
}
}即使没有 API Key,免费功能(灵感搜索、提示词增强、模型列表)也可以直接使用。
Hermes Agent (NousResearch)
Hermes Agent 原生支持 MCP — 在 ~/.hermes/config.yaml 加上:
mcp_servers:
meigen:
command: "npx"
args: ["-y", "[email protected]"]
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) |
| 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 宿主的终端用户:
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 宿主) 章节。
智能 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 节点。
{
"comfyuiUrl": "http://localhost:8188",
"comfyuiDefaultWorkflow": "txt2img"
}适合 Flux、SDXL 或任何你本地运行的模型。图片完全不离开你的机器。
MeiGen 云端
云端 API,支持多种模型:GPT Image 2.0、Nanobanana 2、Seedream 5.0 等。无需 GPU。
获取 API Token:
- 登录 meigen.ai
- 点击头像 → 设置 → API Keys
- 创建新 Key(以
meigen_sk_开头)
{ "meigenApiToken": "meigen_sk_..." }GPT Image 2.0 分辨率与质量 — 默认模型支持两个可选的 generate_image 参数:
resolution:例如"1K"/"2K"/"4K"— 海报、印刷、大屏壁纸时升级quality:例如"low"/"medium"/"high"— 快速草图、缩略图可用"low"省积分
每个模型支持的分辨率和质量档不同 — 运行 list_models 查看各模型实际支持的档位。最新价格请查看 meigen.ai/model-comparison。
自带 API(OpenAI 兼容)
接入任意符合 OpenAI 接口规范的生图 API — Together AI、Fireworks AI、DeepInfra、硅基流动,或你自己的端点。只需提供 Key、请求地址和模型名:
{
"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。 - 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 — 个人和商业用途均免费。
