跳转到主要内容

​
前提条件

  • 已安装 Node.js 18+
  • 至少一个生成提供商(generate_image / generate_video 用):
    • MeiGen Cloud — 从 meigen.ai 获取 API Key（设置 → API Keys）
    • ComfyUI — 运行中的 ComfyUI 服务器（安装指南）
    • OpenAI 兼容 API — 自带 Key，支持 Together AI、Fireworks AI、OpenAI 等任意供应商
无需提供商即可开始使用。画廊搜索、提示词增强和灵感工具无需任何 API Key 即可运行。

​
安装

​
Claude Code 插件（推荐）

1

安装插件

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

# 安装
/plugin install meigen@meigen-marketplace
安装后重启 Claude Code（关闭并重新打开，或打开一个新的终端标签页）。
2

配置提供商

启动一个新的 Claude Code 会话并运行 /meigen:setup。安装向导引导你完成提供商选择和 API Key 配置,自动适配 macOS / Linux / Windows shell。或直接设置环境变量(参见下方提供商配置)。
3

开始使用

用自然语言让 Claude 生成图片或视频:
  • “生成一个咖啡店的极简 Logo”
  • “把这张图动画化成一段 5 秒视频”
  • “在画廊中搜索赛博朋克城市风景”
  • “增强这个提示词:一只猫在太空中”

​
Cursor / VS Code / Windsurf / Roo Code

一行命令写好每个编辑器的 MCP 配置文件: 
npx meigen init cursor      # 写 .cursor/mcp.json
npx meigen init vscode      # 写 .vscode/mcp.json
npx meigen init windsurf    # 写 ~/.codeium/windsurf/mcp_config.json
npx meigen init roo         # 写 .roo/mcp.json
npx meigen init claude      # 写 .mcp.json (Claude Code 项目级)
配置写好后,在 shell 设置 MEIGEN_API_TOKEN 并重启宿主。不支持 /meigen:setup slash 命令的宿主,直接在 meigen server entry 的 env 块加 token。

​
OpenAI Codex CLI

Codex 用 TOML。在 ~/.codex/config.toml 加: 
[mcp_servers.meigen]
command = "npx"
args = ["-y", "meigen@latest"]

[mcp_servers.meigen.env]
MEIGEN_API_TOKEN = "meigen_sk_..."

​
Hermes Agent (NousResearch)

Hermes 原生支持 MCP。在 ~/.hermes/config.yaml 加: 
mcp_servers:
  meigen:
    command: "npx"
    args: ["-y", "meigen@latest"]
    env:
      MEIGEN_API_TOKEN: "meigen_sk_..."
    timeout: 600          # 视频生成可能 5-10 分钟
    connect_timeout: 120  # 首次 npx 拉包可能慢
timeout: 600 和 connect_timeout: 120 这两个覆盖很重要 — Hermes 默认(120s / 60s)是给短命令调好的,视频生成或首次 npx 下载会超时。

​
独立 CLI 模式(不需要 MCP 宿主)

适合 shell 脚本、CI 流水线以及不跑 MCP 宿主的终端用户: 
# 设置 token
export MEIGEN_API_TOKEN=meigen_sk_...

# 生图
npx meigen gen --prompt "阳光厨房里的三花猫"

# 指定模型 + 比例
npx meigen gen -p "logo design" -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 覆盖;Linux 可用 XDG_PICTURES_DIR)。

​
OpenClaw

从 ClawHub 安装完整插件（包含命令、技能和 MCP 服务器）： 
openclaw bundles install clawhub:meigen-ai-design
或仅安装技能（不含命令/agents）： 
npx clawhub@latest install creative-toolkit
OpenClaw 使用 Agent Skills 开放标准。无需配置 MCP — Skill 会处理一切。

​
其它 MCP 兼容宿主

任意吃 stdio MCP 的宿主,把这个加到它的配置文件: 
{
  "mcpServers": {
    "meigen": {
      "command": "npx",
      "args": ["-y", "meigen@latest"],
      "env": {
        "MEIGEN_API_TOKEN": "meigen_sk_..."
      }
    }
  }
}

​
提供商配置

配置一个或多个提供商。当多个提供商可用时，插件按以下顺序选择：MeiGen → ComfyUI → OpenAI 兼容。你可以在每次请求时覆盖此设置。

​
MeiGen Cloud

最简单的入门方式。通过 MeiGen 的托管 API 访问 9 个图像和视频模型 — GPT Image 2、Nanobanana Pro/2、Seedream、Midjourney V8.1、Flux 2 Klein、Seedance 2.0(fast/pro)、Happyhorse 1.0、Veo 3.1。
变量值
MEIGEN_API_TOKEN以 meigen_sk_ 开头的 API Key
获取 API Key：在 meigen.ai 登录 → 点击头像 → 设置 → API Keys → 创建新 Key。
API Key 只能使用购买积分，不能使用每日免费积分。在通过插件生成前，请确保你的账户有购买积分。

​
自带 API（OpenAI 兼容）

接入任意符合 OpenAI 接口规范的生图 API — Together AI、Fireworks AI、DeepInfra、硅基流动、OpenAI，或你自己的端点。
变量值
OPENAI_API_KEY你的供应商 API Key
OPENAI_BASE_URLAPI 端点（如 https://api.together.xyz/v1）
OPENAI_MODEL（可选） 供应商的模型名
设置 OPENAI_BASE_URL 指向你的供应商端点。如果省略，默认使用 OpenAI 的 API。

​
ComfyUI（本地）

在你自己的 GPU 上运行图片生成，完全控制模型、采样器和工作流。免费使用 — 无需 API Key。
变量值
COMFYUI_URLComfyUI 服务器地址（默认：http://127.0.0.1:8188）
要求：
  1. ComfyUI 必须正在运行且可通过配置的 URL 访问
  2. 你需要至少导入一个工作流模板 — 参见 ComfyUI 指南
ComfyUI 串行处理：每次只生成一张图片。

​
验证安装

安装完成后，向你的 AI 助手提问：
“列出可用的模型”
如果配置正确，它会调用 list_models 工具并显示你所有已配置提供商的可用模型。

​
使用

安装完成后，用自然语言向 AI 助手提问即可——例如”生成一幅水彩风景画，16:9 宽高比”。完整工具清单见概览。

​
故障排除

未设置任何提供商。在 Claude Code 上运行 /meigen:setup(交互向导)。在其它宿主(Cursor、Codex、Windsurf、Hermes Agent 等)上,直接在 MCP 配置文件加 env var:
  • MeiGen:MEIGEN_API_TOKEN
  • OpenAI 兼容:OPENAI_API_KEY
  • ComfyUI:COMFYUI_URL(并导入一个工作流)
然后重启宿主。
API Key 只能使用购买积分，不能使用每日免费积分。请在 meigen.ai 购买积分。
  1. 确保 ComfyUI 正在运行（在 ComfyUI 目录中执行 python main.py）
  2. 检查 COMFYUI_URL 是否与 ComfyUI 启动时显示的地址一致（默认：http://127.0.0.1:8188）
  3. 如果在其他机器上运行，确保端口可访问
  1. 打开 ComfyUI Web UI 检查错误信息
  2. 使用 comfyui_workflow view 检查工作流节点
  3. 确保工作流中引用的检查点模型已下载
  4. 先尝试在 ComfyUI 中手动运行工作流
  1. 确保已安装 Node.js 18+
  2. 尝试直接运行 npx -y meigen 检查是否有错误
  3. 重启编辑器
  4. 检查 MCP 配置 JSON 是否有效
生成时间因模型和提供商而异。MeiGen Cloud 模型的生成时间在 5-60 秒之间。ComfyUI 取决于你的 GPU 性能。插件最多等待 5 分钟后超时。
修改 ~/.config/meigen/config.json 或环境变量后，你必须重启编辑器（或启动新的 Claude Code 会话）才能使更改生效。