jau123/MeiGen-AI-Design-MCP · 上手攻略

  • 仓库：jau123/MeiGen-AI-Design-MCP
  • 链接：https://github.com/jau123/MeiGen-AI-Design-MCP
  • 分类：agent-skills
  • 作者：Tom
  • 更新：2026-08-09

是什么

MeiGen（美哏）是一个开源 MCP（Model Context Protocol）服务器，让 AI 编程工具直接变身专业 AI 设计师。它集成了 9 个 MCP 工具 + 1446 条精挑提示词，覆盖图片生成、视频生成、灵感搜索、产品摄影、海报设计等任务，支持 GPT Image 2、Midjourney V8.1、Flux 2 Klein、Seedance、Veo 3.1、ComfyUI（本地离线）等主流模型。核心价值：把"让 AI 画图"这件事从对话变成了结构化、可批量、可编程的设计工作流。

它同时也是一个有代表性的 MCP 生态案例——用一个 MCP 服务器把设计能力标准化地接入所有主流 AI coding 工具（Claude Code、Cursor、Codex、Windsurf、Roo Code、OpenClaw、Hermes Agent），而不是为每个工具单独适配。

解决什么问题

在 AI 编程工具里做设计，往往靠截图发群、人工上传，操作割裂。MeiGen 把设计能力直接塞进 AI coding agent 的工具调用管道，AI 可以自主搜索灵感、优化提示词、批量生成图片、管理 ComfyUI 工作流，无需离开当前对话。一次配置，后续全自动化。

另一个痛点是提示词质量。1446 条精挑提示词解决了"怎么描述我要的设计"这个第一步难题——你可以直接搜索相似场景的提示词模板，稍作修改就用，比凭空写效率高得多。

典型场景：

  • 产品的 4 张不同风格展示图（并行生成）
  • Logo 设计 + 多尺寸导出
  • 参考图 → AI 理解 → 生成配套视觉素材
  • 将图生视频能力接入自动化 pipeline
  • 电商详情页配图批量生成

快速安装

方式一：远程 MCP 端点（推荐，零安装）

# 无需 npm，直接接入远程服务（2026-07-28 stateless Streamable-HTTP 协议）
# 读接口无需 Token；生成图片/视频需要 https://www.meigen.ai 的 API Key
claude mcp add --transport http meigen https://www.meigen.ai/api/mcp \
  --header "Authorization: Bearer meigen_sk_YOUR_TOKEN"

方式二：Claude Code 插件（本地工具链，完整功能）

# 添加插件市场
/plugin marketplace add jau123/MeiGen-AI-Design-MCP

# 安装
/plugin install meigen@meigen-marketplace

# 重启 Claude Code（关闭重开，或开新标签页）

方式三：其他 AI 编程工具

# npm 安装（Node.js >= 18 环境）
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（项目级）

方式四：OpenClaw

openclaw bundles install clawhub:meigen-ai-design

方式五：纯 CLI（无 MCP 主机，CI/CD 友好）

# 设置 Token（从 https://www.meigen.ai → Settings → API Keys 获取）
export MEIGEN_API_TOKEN=meigen_sk_YOUR_TOKEN

# 一键生成，图片保存到 ~/Pictures/meigen/
npx meigen gen --prompt "a calico cat in a sunlit kitchen"

# 指定模型和比例
npx meigen gen -p "tech logo" -m midjourney-v8.1 -r 1:1

# 带参考图（本地文件自动上传）
npx meigen gen -p "product hero shot" --ref ~/Desktop/bottle.jpg

# CI 友好：只提交不等待，打印 generationId
npx meigen gen -p "..." --no-wait

# JSON 输出（便于 jq 管道）
npx meigen gen -p "..." --json | jq -r '.imageUrls[0]'

核心用法

MCP 工具集（共 9 个）

工具 是否需要 Key 用途
search_gallery 免费 搜索 1446 条精挑提示词，带视觉预览
get_inspiration 免费 获取完整提示词、图片及元数据
enhance_prompt 免费 将简短想法润色为专业图像提示词
list_models 免费 列出所有可用模型及当前配置
comfyui_workflow 免费 管理 ComfyUI 工作流模板
manage_preferences 免费 记住偏好风格、比例、模型
generate_image 需要 Key 图片生成，自动路由到最优 Provider
generate_video 需要 Key 视频生成，需指定模型 ID
check_generation 免费 按 ID 查询生成状态（用于中断后恢复）

交互式命令

/meigen:gen <prompt>   # 快速生成，跳过对话
/meigen:find <关键词>   # 搜索提示词库找灵感
/meigen:models         # 浏览并切换 AI 模型
/meigen:setup          # 交互式配置向导（Provider 选择 + 填 Key）

三种后端模式详解

  1. MeiGen Cloud：开箱即用，模型阵容由平台维护，型号实时更新（GPT Image 2、Nanobanana 2、Seedream 5.0、Seedance 2.0 等），无需自己运维
  2. OpenAI 兼容 API：自带 Key + 端点，接入自己偏好的服务商，适合有固定供应商的企业场景
  3. 本地 ComfyUI：完全离线，用自己的 GPU，适合对数据隐私有要求或网络受限的环境；需要自己先部署 ComfyUI 服务

首次配置示例（Claude Code）

# 重启后，在 Claude Code 输入：
/meigen:setup

# 按向导选择 Provider → 填入 API Token → 再重启一次
# 之后直接对话：
"给这个产品做 4 张不同风格的展示图"

典型适用场景

  1. 电商产品摄影：参考图 → AI 理解 → 批量并行生成多风格产品图，4 张图 <2 分钟。Demo 中展示的香水产品案例：AI 上传参考图 → 写 4 条不同风格提示词 → 并行生成，结果张力十足
  2. 品牌视觉素材：Logo → 多尺寸变体 → 海报 → 社交媒体配图，一条流水线
  3. 自动化 CI 设计：用 npx meigen gen --no-wait 在构建 pipeline 里自动生成配图，适合 AIGC 内容自动化生产
  4. AI Coding 工具里的设计：不切出 IDE，直接让 AI agent 帮你出图，保持上下文不中断
  5. 视频素材生成：结合图生视频模型（Veo、Grok Video 等）做 AIGC 短视频素材

坑与注意

  1. Hermes Agent 用户特别注意：timeout 必须设 2700（视频最长 15 分钟），connect_timeout 设为 120（首次 npx 下载可能超过默认 60s），README 明确标注了这两个 override，漏了视频会超时
  2. CLI 输出路径：图片默认 ~/Pictures/meigen/，视频 ~/Movies/meigen/，可 MEIGEN_OUTPUT_DIR 环境变量覆盖
  3. 模型版本号：README 提到 midjourney-v8.1、seedance-2.0 等，但各平台模型版本更新频繁，list_models 返回的是实时阵容，下单前先查
  4. ComfyUI 本地模式：需要自己先跑通 ComfyUI 服务，MeiGen 只负责调用，工作流模板管理是亮点但不能帮你装 ComfyUI
  5. Token 安全：不要把 meigen_sk_... 写进公开代码，建议用环境变量注入，README 也有同样警示
  6. 生成等待：generate_video 是轮询模式，长视频可能跑 15+ 分钟，需要足够的 timeout 配置；Hermes Agent 用户建议直接看 README 中的 yaml 配置示例

与同类对比

方案 集成度 本地离线 模型范围 CLI 定位
MeiGen ⭐⭐⭐⭐⭐（MCP 原生） ✅ ComfyUI 10+ 云端 + 本地 ✅ 设计工具链深度集成
browserbase/skills ⭐⭐⭐（浏览器自动化） ❌ 主要 MJ/SD ❌ 网页自动化场景
直接调 API ⭐（无工具链） 视配置 受限 ✅ 简单场景够用

MeiGen 的核心竞争力是 MCP 工具链 + 提示词库 + 多后端路由，是专门为 AI coding agent 设计的设计外挂，而非通用 API 封装。相比 browserbase/skills 的浏览器截图路线，MeiGen 走的是"设计工具原生集成"路线，更适合直接在 AI coding 工具内完成设计任务。

一句话推荐结论

如果你的 AI coding 工具需要随时出图、设计素材、产品摄影，MeiGen 是目前最成熟的 MCP 设计方案——零门槛接入、多后端灵活切换、1446 条现成提示词，远程端点模式下连 npm 都不需要。

最小可跑命令

# 依赖：Node.js >= 18，npm；MeiGen Cloud API Key（免费注册 https://www.meigen.ai）
# 模型：GPT Image 2 / Midjourney V8.1 / Flux 2 Klein 等（需 Key，模型阵容以 npx meigen models 为准）
# 硬件：仅需 Node.js 环境，生成在云端或本地 ComfyUI 执行

# 1. 安装 CLI（验证环境）
npx -y meigen@1.4.0 gen --help

# 2. 配置 Token（替换 YOUR_TOKEN）
export MEIGEN_API_TOKEN=meigen_sk_YOUR_TOKEN

# 3. 一键生图（默认比例）
npx meigen gen --prompt "a minimalist tech logo"

# 4. 指定模型和比例
npx meigen gen -p "product hero shot" -m midjourney-v8.1 -r 16:9 --json

# 5. 查看可用模型列表（免费，不需要 Key）
npx meigen models

原始来源：GitHub README · npm meigen · YouTube Demo

不确定处：midjourney-v8.1、seedance-2.0 等具体模型版本号为 README 标注的命名，实际版本号建议以 npx meigen models 返回为准；meigen@1.4.0 为写作时 npm 最新版本号，可能有更新。