MeiGen AI Design MCP

MeiGen AI Design MCP 快速入门

「让 Claude Code / Cursor / Codex 直接帮你出图出片」——MeiGen AI Design MCP（jau123/MeiGen-AI-Design-MCP）是一个开源 MCP 服务器，把主流图像/视频生成模型（GPT Image 2、Nanobanana 2、Seedream 5.0、Midjourney V8.1、Flux 2 Klein、Grok Imagine、Seedance 2.0、Veo 3.1 等）和本地 ComfyUI 聚合成统一的工具接口，供任何 MCP 宿主调用。MIT，npm 包 meigen，当前 2.0.1。2026-09-24 核验：GitHub 1,772★ / 231 fork，最近 push 2026-09-17，被 Awesome MCP Servers 收录。

这是什么？适合谁？

MeiGen 解决的是「AI 编程工具里的生成能力碎片化」：你在 Claude Code 里想让 AI 帮你生成产品图，得自己去开网页、复制提示词、下载再贴回来。MeiGen 把 14-17 个生成工具（generate_image、generate_video、list_models 等）装进 MCP，AI 助手直接调用；再配 1,446 条精选提示词库、并行子 Agent 编排、五大电商/图像 Skills，以及不依赖宿主的独立 CLI 模式。

适合人群：

• Claude Code / Cursor / Codex / Windsurf / Roo Code / OpenClaw 用户：想让编码 agent 顺手完成配图、视频、电商素材
• 电商从业者：官方五个引导式 Skills（抠图、电商图等）开箱即用
• 需要统一接口切换多家生成模型的团队：一个 MCP 覆盖十余家 provider + 本地 ComfyUI

不适合谁：只偶尔生成一张图的轻度用户（各家官网免费额度更省事）；完全离线环境（远端模式需联网，本地模式仍需 API key）。

准备工作

• 运行环境：Node.js（npx 拉起本地服务器）或直接用远程服务器（免安装）；支持 Claude Code、Cursor、Codex、Windsurf、Roo Code、OpenClaw、Hermes Agent 等 MCP 宿主
• 账号与费用：
  • 远程服务器模式：注册 meigen.ai，充值购买积分（API 生成不用每日免费积分；五个 Skills 无免费次数，含首次抠图）
  • 本地 npm 模式：自备 provider key（OPENAI_API_KEY 等任意 OpenAI 兼容）或本地 ComfyUI（图像生成免费）
• 时间预算：远程模式 5 分钟；本地模式 10-15 分钟
• 前置知识：会在你的 AI 工具里配置 MCP；知道怎么买 API 额度

快速上手

第一步：初始化（本地 npm 模式，最常用）

在你的 AI 工具里执行对应命令：

npx -y meigen@2.0.1 init claude      # Claude Code（项目级）
npx -y meigen@2.0.1 init cursor      # Cursor
npx -y meigen@2.0.1 init vscode      # VS Code / GitHub Copilot
npx -y meigen@2.0.1 init windsurf    # Windsurf
npx -y meigen@2.0.1 init roo         # Roo Code

Codex 用户用 codex mcp add meigen -- npx -y meigen@2.0.1，再按文档加环境变量转发与超时设置。

第二步：配置 key

• 远程模式：claude mcp add --transport http meigen https://www.meigen.ai/api/mcp --header "Authorization: Bearer YOUR_M...EY"，并在 Profile → Top Up 充值购买积分（同账号，手机端用 Premium 页）
• 本地模式：设置 OPENAI_API_KEY（任意 OpenAI 兼容 provider）或配置本地 ComfyUI 地址

第三步：第一个任务

在你的 AI 助手里直接说：

用 meigen 生成一张图：阳光厨房里的三花猫

或用独立 CLI（不依赖任何宿主）：

npx -y meigen@2.0.1 gen --prompt "a calico cat in a sunlit kitchen"
npx -y meigen@2.0.1 gen -p "tech logo" -m midjourney-v8.1 -r 1:1
npx -y meigen@2.0.1 gen -p "product hero shot" --ref ~/Desktop/bottle.jpg

预期产出：图片 URL 直接返回给 AI 助手或以 --json 输出（.imageUrls[0]）。list_models 可查看每个模型的分辨率与质量档位。

第四步：视频与 Skills

• 视频：generate_video（2.0.1 起支持多参考视频与参考音频，本地 .mp4/.mov/.wav/.mp3 自动上传）
• 电商 Skills：list_skills 查看五个引导式 Skills 及当前价格；npx clawhub@latest install creative-toolkit 安装创意工具包

常见踩坑

1. 症状：API 调用报积分不足，但网站明明显示有余额。 根因：API 用购买积分，不用每日免费积分。解法：去 Profile → Top Up 给同一账号充值；被拒的调用不要轮询重试。
2. 症状：视频生成或首次 npx 下载超时。 根因：默认 MCP 超时（如 Hermes 默认 120s/60s）按短工具调优。解法：按文档设 timeout: 2700 与 connect_timeout: 120（首次 npx 下载可能要一分钟）。
3. 症状：升级后工具数量不对。 根因：远程服务器（14 工具）与本地 npm（17 工具）工具集不同；远程工具变更需后端部署而非 npm 发版。解法：核对 list_models/文档预期，必要时重载宿主的工具列表。
4. 症状：五个 Skills 报无权限/扣费。 根因：Skills 走 MeiGen Cloud 且无免费次数（含第一次抠图），不接受 BYOK、不能跑在 ComfyUI 上。解法：先 list_skills 看清价格再用；想省钱用本地 generate_image + 自己的 ComfyUI。
5. 症状：参考图上传失败。 根因：文件路径/格式问题。解法：2.0.0 起有上传校验与请求恢复，按报错信息修正路径；本地文件需在宿主可访问的路径上。
6. 症状：固定了旧版本配置不生效。 根因：钉死的版本号落后。解法：本地钉定配置改 meigen@2.0.1 后重启；全局安装跑 npm install -g meigen@2.0.1。

权限、安全与成本边界

• 许可：MIT，个人商用皆可
• 成本结构：本地 npm + 自备 key/ComfyUI = 费用完全自控（ComfyUI 图像免费）；远程模式与 Skills 按 MeiGen Cloud 积分计费（meigen.ai/model-comparison 有全模型价格表）
• 网络：远程模式必须联网；本地模式调 API 需联网，纯 ComfyUI 可离线生成
• 数据：参考图/视频会上传到所用 provider（远程=MeiGen 云，本地=你配的 API 或本机 ComfyUI）

小技巧

1. 先 list_models 再生成：每个模型的分辨率与质量档位不同，避免生成后再返工。
2. 独立 CLI 的 --json | jq -r '.imageUrls[0]' 适合写进脚本做批量素材管线。
3. --no-wait 提交后干别的，配合请求恢复机制稍后取结果。
4. 电商场景直接用五个官方 Skills（引导式流程比裸调 generate_image 稳），普通创作用 CLI + ComfyUI 省钱。
5. 给宿主加长超时（2700s）再跑视频任务，否则中途断连最坑。

进阶学习方向

• MCP 多宿主分发：研究 meigen init 的宿主适配层，学习一个 MCP 如何同时服务 Claude Code/Cursor/Codex/Windsurf/Roo/OpenClaw。
• 并行子 Agent 编排：README 的 parallel sub-agent orchestration 设计，适合批量出图场景二开。
• HTTP API：SKILLS_API.md 提供绕过 MCP 的 HTTP 接口，可嵌入自有服务。
• 组合链路：MeiGen（生成）→ ComfyUI（免费图像底座）→ Claude Code（编排），官方文档对 Hermes Agent 的超时配置示例可直接套用。

参考链接

• 官方仓库
• npm 包 meigen
• 模型价格对比
• HTTP API 文档
• 中文 README