- 🎨 6 种生成类型 — 图片、视频、3D、SVG、音频、音乐
- 🔌 30+ 提供商 — 统一接口
- 💻 本地服务器 — 在你的机器上运行,连接 Comfy API
- 🔍 内置模型搜索 — 支持 BM25 全文搜索
- 🧩 即插即用 — 兼容 Claude Desktop、Claude Code 和 Amp
环境要求
- Node.js 20+
- pnpm 10
- Comfy API 密钥(以
comfyui-开头)— 从 Comfy 合作面板获取
安装
packages/mcp/dist/bin.js。
配置
将服务器添加到你的 MCP 客户端配置中。以下 JSON 格式适用于 Claude Desktop、Claude Code 和 Amp:| 客户端 | 配置文件 |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%/Claude/claude_desktop_config.json (Windows) |
| Claude Code | ~/.claude/mcp.json(或运行 claude mcp add) |
| Amp | 设置 → MCP 服务器,或 ~/.config/amp/settings.json |
comfy-partner 服务器下看到注册的 10 个工具。
如需在接入客户端之前验证服务器是否正常启动,可直接运行以下命令——正常情况下会打印 JSON-RPC 握手信息并保持等待:
环境变量
| 变量 | 必需 | 说明 |
|---|---|---|
COMFY_API_KEY | 是 | API 密钥(comfyui-…)。以 X-API-Key 头发送。 |
COMFY_API_BASE_URL | 否 | 覆盖代理主机地址(默认 Comfy API 生产环境)。 |
COMFY_INLINE_LIMIT_KB | 否 | 工具结果中内联图片字节数上限。默认 600。 |
COMFY_MCP_RESOURCE_LINKS | 否 | 强制开启/关闭 resource_link 内容块。默认为白名单模式(claude-*、mcp-inspector)。 |
可用工具
MCP 服务器共提供 10 个工具。安装成功后,你的 MCP 客户端应在comfy-partner 服务器下看到全部 10 个工具。
| 工具 | 说明 |
|---|---|
generate_image | 生成静态图片 — 支持文生图、图片编辑和超分辨率 |
generate_video | 生成视频片段 — 支持文生视频、图生视频和口型同步 |
generate_3d | 从文字或参考图生成 3D 网格(GLB/FBX/OBJ) |
generate_svg | 从文字提示生成 SVG 矢量插画 |
generate_audio | 从文字生成语音、声音克隆或音效 |
generate_music | 从提示词生成纯音乐或带人声的音乐 |
media_upload | 上传文件(图片/视频/音频),获取可在 generate_* 调用中使用的 media:<id> 引用 |
read_media | 获取并内联渲染媒体 artifact — 接受 HTTPS URL 或 media:… token |
models_explore | 发现模型、按能力搜索,并读取模型的完整调用结构 |
balance | 查询当前账户余额(USD) |
使用示例
安装后在 AI 助手中尝试以下提示:相关文档
- Comfy Cloud MCP — 面向 Comfy Cloud 工作流执行的托管 MCP 服务器
- Comfy Partner Nodes CLI — 从命令行使用合作节点