MCP 插件安装 - MeiGen Docs

前提条件

本地包建议使用 Node.js 22+
普通 generate_image 可配置以下后端之一；generate_video 和五项 Skills 必须使用 MeiGen Cloud：
- MeiGen Cloud — 用桌面浏览器在 API Keys 获取 Key
- ComfyUI — 运行中的 ComfyUI 服务器（安装指南）
- OpenAI 兼容 API — 自带 Key，支持 Together AI、Fireworks AI、OpenAI 等任意供应商

无需提供商即可开始使用。画廊搜索、提示词增强和灵感工具无需任何 API Key 即可运行。

复制给 AI 助手安装

可复制给能编辑 MCP 配置的本地 Codex、Claude Code、Cursor 等助手：

为当前宿主安装 MeiGen MCP，保留其他服务并复用已有 MeiGen 条目。
优先使用 https://www.meigen.ai/api/mcp 的 Streamable HTTP；需要读取本地文件
或本地专属工具时，使用 npx -y meigen@2.0.0。
Codex 远程配置使用 bearer_token_env_var = "MEIGEN_API_TOKEN"；如果尚未设置
Key，先省略认证并验证公开工具。指导我私密填写 Key，不让我把它发到聊天或 URL。
重连后实际调用 list_skills 并报告结果；安装验证不要上传、生成或消耗积分。
如果无法修改宿主配置，给出准确手动步骤并说明哪些尚未验证。
ChatGPT 网页请使用独立的仅公开查询流程。

Codex HTTP 和 ChatGPT 网页的步骤见远程接入。

安装

想零安装?远程 MCP 端点不需要 Node.js 或本地 npx 进程，但仍需配置支持 HTTP 的 MCP 宿主通过 HTTP 指向 https://www.meigen.ai/api/mcp 即可。

Claude Code 插件

安装插件

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

# 安装
/plugin install meigen@meigen-marketplace

安装后重启 Claude Code（关闭并重新打开，或打开一个新的终端标签页）。

配置提供商

启动一个新的 Claude Code 会话并运行 /meigen:setup。根据指引选择提供商，凭据由你自己在宿主私密设置或本地配置中填写，不发到对话。插件可附带 MCP 配置，请检查已有服务，避免重复添加。或直接设置环境变量(参见下方提供商配置)。

开始使用

用自然语言让 Claude 生成图片或视频:

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

也上架在社区市场 wshobson/agents。第三方上架版本可能滞后，请检查实际安装包，仅在缺少 MCP 连接时补充配置。

Cursor / VS Code / Windsurf / Roo Code

一行命令写好每个编辑器的 MCP 配置文件:

npx -y meigen@2.0.0 init cursor      # 写 .cursor/mcp.json
npx -y meigen@2.0.0 init vscode      # 写 .vscode/mcp.json
npx -y meigen@2.0.0 init windsurf    # 写 ~/.codeium/windsurf/mcp_config.json
npx -y meigen@2.0.0 init roo         # 写 .roo/mcp.json
npx -y meigen@2.0.0 init claude      # 写 .mcp.json (Claude Code 项目级)

init 助手生成的配置会跟随 npm 最新发布。要固定本版本，请把生成的 args 改为 meigen@2.0.0；以固定版本执行 init 本身不会固定生成条目。请在 MCP 进程环境或宿主私密设置中配置凭据，然后重启。

Codex CLI、IDE 扩展和本地 Codex 桌面宿主

MeiGen Cloud 和 Skills 建议使用远程 HTTP。需要本地进程时，将以下内容合并到 ~/.codex/config.toml，替代远程条目：

[mcp_servers.meigen]
command = "npx"
args = ["-y", "meigen@2.0.0"]
env_vars = ["MEIGEN_API_TOKEN"]
startup_timeout_sec = 90
tool_timeout_sec = 240

在启动 Codex 的环境中设置 MEIGEN_API_TOKEN。未配置 Key 时先省略 env_vars，待变量存在后再加。Codex 不会自动加载项目 .env.local。也可先执行 codex mcp add meigen -- npx -y meigen@2.0.0 注册命令，再在已有表中补环境变量转发和超时。meigen init codex 不受支持。 240 秒适用于 Skills；较长的通用视频生成可能需要更久。重启/重连后查看 codex mcp list 和 /mcp，并真实调用一次 list_skills。参考 Codex 官方配置指南。ChatGPT 网页不共享这套本地安装，当前 MeiGen 认证方式下仅支持公开查询。

Hermes Agent (NousResearch)

Hermes 原生支持 MCP。在 ~/.hermes/config.yaml 加:

mcp_servers:
  meigen:
    command: "npx"
    args: ["-y", "meigen@2.0.0"]
    env:
      MEIGEN_API_TOKEN: "meigen_sk_..."
    timeout: 2700           # 长视频(如参考视频续写)可能超过 15 分钟
    connect_timeout: 120    # 首次 npx 拉包可能慢

timeout 要设成 2700,不能用 Hermes 默认值(120s)。长视频生成 — 尤其参考视频续写 — 可能超过 15 分钟;超时太短会在任务仍在服务端运行、积分已扣的情况下把 Hermes 连接断掉。connect_timeout: 120 用来兜住首次 npx 下载慢的情况。生成中途连接断开时，用原 generationId 或已保存 UUID requestId 调 check_generation。恢复要求重交时保留原 ID 和精确参数，新 ID 才是新付费尝试。组合步骤可用 wait=false/download=false，详见工作流恢复。

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

适合 shell 脚本、CI 流水线以及不跑 MCP 宿主的终端用户:

# 设置 token
export MEIGEN_API_TOKEN=meigen_sk_...

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

# 指定模型 + 比例
npx -y meigen@2.0.0 gen -p "logo design" -m midjourney-v8.1 -r 1:1

# 带参考图(本地路径自动上传)
npx -y meigen@2.0.0 gen -p "产品 hero shot" --ref ~/Desktop/bottle.jpg

# 只提交不等待 — 输出 generationId(适合 CI)
npx -y meigen@2.0.0 gen -p "..." --no-wait

# JSON 输出(适合 jq 管道)
npx -y meigen@2.0.0 gen -p "..." --json | jq -r '.imageUrls[0]'

图像默认保存到 ~/Pictures/meigen/ — 改保存位置见输出目录。

OpenClaw

MeiGen 另以 meigen-ai-design bundle 与 creative-toolkit Skill 分发，两者是独立产物、版本也独立。支持的安装命令和当前包结构请参考仓库安装指南。检查实际安装清单，仅配置一套 MCP 连接；安装独立 Skill 不等于已连接 MCP 服务。

其它 MCP 兼容宿主

任意吃 stdio MCP 的宿主,把这个加到它的配置文件:

{
  "mcpServers": {
    "meigen": {
      "command": "npx",
      "args": ["-y", "meigen@2.0.0"],
      "env": {
        "MEIGEN_API_TOKEN": "meigen_sk_..."
      }
    }
  }
}

提供商配置

以下提供商选择适用于普通图片生成；Skills 始终要求 MeiGen Key 和购买积分。可配置一个或多个提供商。当多个提供商可用时，插件按以下顺序选择：MeiGen → ComfyUI → OpenAI 兼容。你可以在每次请求时覆盖此设置。

MeiGen Cloud

最简单的入门方式。MeiGen 的托管 API 汇集了 OpenAI、Google、ByteDance、Midjourney、xAI、Black Forest Labs、Alibaba、Agnes 的图像与视频模型 — 无需 GPU。当前清单用 list_models 查，能力与定价见模型对比。

变量	值
`MEIGEN_API_TOKEN`	以 `meigen_sk_` 开头的 API Key

用桌面浏览器在 API Keys 创建 Key；同账号在个人主页点击充值，或使用移动端充值页。

API Key 只能使用购买积分，不能使用每日免费积分。在通过插件生成前，请确保你的账户有购买积分。

自带 API（OpenAI 兼容）

接入任意符合 OpenAI 接口规范的生图 API — Together AI、Fireworks AI、DeepInfra、硅基流动、OpenAI，或你自己的端点。

变量	值
`OPENAI_API_KEY`	你的供应商 API Key
`OPENAI_BASE_URL`	API 端点（如 `https://api.together.xyz/v1`）
`OPENAI_MODEL`	（可选）供应商的模型名

设置 OPENAI_BASE_URL 指向你的供应商端点。如果省略，默认使用 OpenAI 的 API。

ComfyUI（本地）

在你自己的 GPU 上运行图片生成，完全控制模型、采样器和工作流。免费使用 — 无需 API Key。

变量	值
`COMFYUI_URL`	ComfyUI 服务器地址（默认：`http://127.0.0.1:8188`）

要求：

ComfyUI 必须正在运行且可通过配置的 URL 访问
你需要至少导入一个工作流模板 — 参见 ComfyUI 指南

ComfyUI 串行处理：每次只生成一张图片。

输出目录

通用图片/视频生成和独立 CLI 可保存本地文件。专用 Skills 返回图片 URL/资源链接，需要本地文件时请明确下载。

类型	默认位置	覆盖变量	Linux 备选
图片	`~/Pictures/meigen/`	`MEIGEN_OUTPUT_DIR`	`XDG_PICTURES_DIR`
视频	`~/Movies/meigen/`	`MEIGEN_VIDEO_OUTPUT_DIR`	`XDG_VIDEOS_DIR`

设置方式与提供商变量相同 — 写在 MCP 配置的 env 块里，或在 shell 里 export 供 CLI 使用。

验证安装

安装完成后，向你的 AI 助手提问：

“列出 MeiGen 当前可用的 Skills 和价格”

确认真实 list_skills 调用成功，且未生成或扣点；另用 list_models 查看通用生成后端。仅保存配置不代表连接成功。

使用

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

从旧版本升级

原有 MeiGen Key、MEIGEN_API_TOKEN 和私有 ~/.config/meigen/config.json 可继续使用。固定旧 npm 版本的配置改为 meigen@2.0.0 后重启；跟随最新版本的配置也要重启，并核对实际版本/工具。本地 npm 提供 17 个工具，原九个工具保留；新增专用流程会改变 Agent 对 Skills 请求的工具选择。 Claude/OpenClaw 指引和清单通过各自渠道更新，单独升级 npm 不会替换它们。远程用户不需要升级 npm，后端部署后刷新/重连即可；无需强制从本地切换远程。参考源码与发布说明。 Skill 图片限制、中断恢复、缩图确认和价格变化见 Skills API 指南。Skill 上传失败不能触发付费提交或状态轮询。

故障排除

'No image generation providers configured'

未设置任何提供商。在 Claude Code 上运行 /meigen:setup(交互向导)。在其它宿主(Cursor、Codex、Windsurf、Hermes Agent 等)上,直接在 MCP 配置文件加 env var:

MeiGen:MEIGEN_API_TOKEN
OpenAI 兼容:OPENAI_API_KEY
ComfyUI:COMFYUI_URL(并导入一个工作流)

然后重启宿主。

'Insufficient credits'（MeiGen）

API Key 只能使用购买积分，不能使用每日免费积分。请用 Key 所属账号，在个人主页点击充值，或使用移动充值页。

ComfyUI 连接被拒绝

确保 ComfyUI 正在运行（在 ComfyUI 目录中执行 python main.py）
检查 COMFYUI_URL 是否与 ComfyUI 启动时显示的地址一致（默认：http://127.0.0.1:8188）
如果在其他机器上运行，确保端口可访问

ComfyUI 生成失败

打开 ComfyUI Web UI 检查错误信息
使用 comfyui_workflow view 检查工作流节点
确保工作流中引用的检查点模型已下载
先尝试在 ComfyUI 中手动运行工作流

插件未出现在工具列表中

确保已安装 Node.js 22+
尝试直接运行 npx -y meigen@2.0.0 检查是否有错误
重启编辑器
检查 MCP 配置 JSON 是否有效

生成超时

生成时间因模型而异 — MeiGen Cloud 图片模型通常一分钟以内完成;视频生成更久,参考视频续写尤其如此。轮询不再是固定 5 分钟或 8 分钟的客户端超时,而是跟随服务端自身的进度信号,仅保留 45 分钟的防挂起安全阀。连接或轮询中断时，用原 generationId 或已保存 UUID requestId 调 check_generation 恢复。保留精确参数和 ID，临时失败不能重新分配 ID。详见工作流恢复。ComfyUI 生成仍固定 5 分钟上限(取决于你本地 GPU)。

配置修改未生效

修改 ~/.config/meigen/config.json 或环境变量后，你必须重启编辑器（或启动新的 Claude Code 会话）才能使更改生效。

​前提条件

​复制给 AI 助手安装

​安装

​Claude Code 插件

​Cursor / VS Code / Windsurf / Roo Code

​Codex CLI、IDE 扩展和本地 Codex 桌面宿主

​Hermes Agent (NousResearch)

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

​OpenClaw

​其它 MCP 兼容宿主

​提供商配置

​MeiGen Cloud

​自带 API（OpenAI 兼容）

​ComfyUI（本地）

​输出目录

​验证安装

​使用

​从旧版本升级

​故障排除

前提条件

复制给 AI 助手安装

安装

Claude Code 插件

Cursor / VS Code / Windsurf / Roo Code

Codex CLI、IDE 扩展和本地 Codex 桌面宿主

Hermes Agent (NousResearch)

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

OpenClaw

其它 MCP 兼容宿主

提供商配置

MeiGen Cloud

自带 API（OpenAI 兼容）

ComfyUI（本地）

输出目录

验证安装

使用

从旧版本升级

故障排除