agents meigen-ai-design 插件怎么设置:MCP 服务器配置与图像生成 Provider 选择
【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents
在 agents 插件市场(Multi-harness agentic plugin marketplace)中安装meigen-ai-design插件后,如果直接运行/meigen-ai-design:gen生图,往往会遇到两个问题:MCP 工具不可用(没配置 meigen MCP 服务器)、或者提示 "No image generation providers configured"(没配置图像生成 Provider)。本文按插件 README 给出的完整路径,把 MCP 服务器配置和 Provider 选择一次做完,并给出验证与排查方式。适用环境是 Claude Code + Node.js 18+,配置完成后的目标是:先跑通免费功能,再跑通一次真实图像生成。
前提:插件本体与 Node.js 版本
meigen-ai-design是市场里的 Creative 类插件,包含 3 个 agents(gallery-researcher、prompt-crafter、image-generator)和 2 个命令(gen、find)。插件本体通过市场命令安装:
/plugin marketplace add wshobson/agents /plugin install meigen-ai-design第一条命令注册整个市场目录但不加载任何 agent 或工具,第二条才把该插件的 agents、commands、skills 载入上下文。README 明确要求Node.js 18+,因为 MCP 服务器通过npx拉起,先确认本机node -v满足版本再往下走。
第一步:配置 meigen MCP 服务器
把下面的内容写入项目根目录的.mcp.json(如果文件已存在其他服务器,把meigen这一项合并进现有mcpServers字段,不要整体覆盖):
{ "mcpServers": { "meigen": { "command": "npx", "args": ["-y", "meigen@1.4.0"] } } }这里的meigen@1.4.0是 README 指定的固定版本,-y让 npx 自动确认安装。保存后必须重启 Claude Code,README 的 Troubleshooting 表也确认了这一点:MCP 工具不可用的标准处理就是添加.mcp.json配置后重启。
重启完成后的第一个检查点是免费功能——这一步不需要任何 Provider:
"Search the gallery for product photography inspiration"README 把它列为 setup 后的首个验证用例。如果这句话能返回 gallery 搜索结果,说明mcp__meigen__search_gallery工具已经可用,MCP 配置成功;如果工具不存在或调用失败,说明.mcp.json未生效,回到检查文件位置与是否重启 Claude Code。
第二步:选择并配置图像生成 Provider
免费功能(search_gallery、enhance_prompt、list_models、manage_preferences)不需要 Provider,但generate_image必须配置至少一个 Provider。README 给出三条可选路径,按使用条件选一条即可:
选项 A:MeiGen Cloud(README 标注 Recommended)
- 在 meigen.ai 注册,进入 avatar → Settings → API Keys 创建一个以
meigen_sk_开头的 key; - 设置环境变量:
export MEIGEN_API_TOKEN=meigen_sk_your_token_here其中meigen_sk_your_token_here需要替换为你自己创建的 key(README 原文即以此为占位示例)。
选项 B:本地 ComfyUI(免费、私有)
- 安装并启动 ComfyUI(README 给出的是 ComfyUI 官方仓库地址);
- 设置环境变量指向本地实例:
export COMFYUI_URL=http://localhost:8188- 从 ComfyUI 导出 workflow(API 格式 JSON)并通过插件导入。此选项没有云端依赖,但要求 ComfyUI 在配置的 URL 上保持运行,否则会出现后文"connection refused"的排查项。
选项 C:OpenAI 兼容 API(自带 Key)
适用于 OpenAI、Together AI、Fireworks AI 等兼容接口,需要三个环境变量:
export OPENAI_API_KEY=your_key_here export OPENAI_BASE_URL=https://api.openai.com/v1 export OPENAI_MODEL=gpt-image-1OPENAI_API_KEY与OPENAI_BASE_URL、OPENAI_MODEL按你实际使用的服务和模型替换。如果不希望走环境变量,README 说明配置也可以存放在~/.config/meigen/config.json,两者是同一层配置的替代存放位置。
验证生成链路是否打通
Provider 配置后,用 README 给出的第二个验证用例做端到端测试:
"Generate a product photo for a glass perfume bottle on marble"这句话会走gen命令的完整链路:prompt 超过 10 个词时直接使用,然后委托给image-generatoragent 调用mcp__meigen__generate_image,返回完整的工具响应文本。两个值得注意的行为(来自 image-generator agent 的定义):
- 该 agent 调用
generate_image时不指定model和provider,由服务器自动检测——也就是说你在上一步配置的所有 Provider 由服务端选择,而不是在插件侧硬编码; - 如果调用方没有传
aspectRatio,则从参数中省略,服务器默认"auto"并根据 prompt 推断比例;只有明确需要(如"16:9"、"1:1")时才显式传入。
生成成功即完成整个 setup:MCP 工具可用 + Provider 可用两条链都已验证。
常见问题对照表
README 的 Troubleshooting 表与当前场景直接相关的排查项:
| 现象 | 处理方式 |
|---|---|
| MCP tools not available | 添加.mcp.json配置后重启 Claude Code |
| "No image generation providers configured" | 按上文配置至少一个 Provider |
| API key / authentication errors | 检查环境变量或~/.config/meigen/config.json |
| ComfyUI connection refused | 确认 ComfyUI 正在配置的 URL 上运行 |
| Generation timeout | 服务端负载高,稍后重试 |
| Empty gallery search results | 换关键词或使用更宽泛的词 |
后续可用的两个快捷命令
Setup 完成后,日常使用走插件自带的命名空间命令(格式/plugin-name:command-name [arguments]):
/meigen-ai-design:gen <prompt>— 快速生图,跳过意图评估直接生成;prompt 短于 10 个词时会先调用mcp__meigen__enhance_prompt扩写,长于 10 词直接使用;/meigen-ai-design:find <keywords>— gallery 检索浏览灵感,无参数时返回 trending picks。
更多命令说明见 docs/usage.md,插件目录结构见 plugins/meigen-ai-design/README.md,市场安装机制见 docs/plugins.md。
边界说明
- 三个 Provider 选项是 README 并列给出的替代路径,按环境(云服务 / 本地 ComfyUI / 自带 Key)三选一,不需要同时配置多个;
- 免费功能与生成功能相互独立:Provider 配置失败不影响 gallery 搜索、prompt 扩写、模型列表和偏好管理这四类工具;
- 本文所有命令与配置值均来自插件 README,若仓库后续升级
meigen版本或 Provider 机制,以 plugins/meigen-ai-design/README.md 的最新内容为准。
【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考