Agent Tools 与 MCP

Comfy Partner MCP

在本地运行的 MCP 服务器，提供覆盖 30+ 合作提供商（BFL、Ideogram、Kling、Runway、Veo、Meshy、ElevenLabs 等）的统一生成工具。

官方中文源 / agent-tools/partner-mcp.mdx / 固定提交 e433279d

Comfy Partner MCP 是一个本地运行的 MCP 服务器，为 AI 助手提供覆盖 30+ 合作提供商（包括 BFL、Ideogram、Kling、Runway、Veo、Meshy、ElevenLabs 等）的统一生成工具。所有生成类型使用统一的请求格式。

主要特性：

🎨 6 种生成类型 — 图片、视频、3D、SVG、音频、音乐
🔌 30+ 提供商 — 统一接口
💻 本地服务器 — 在你的机器上运行，连接 Comfy API
🔍 内置模型搜索 — 支持 BM25 全文搜索
🧩 即插即用 — 兼容 Claude Desktop、Claude Code 和 Amp

环境要求

Node.js 20+
pnpm 10
Comfy API 密钥（以 comfyui- 开头）— 从 Comfy 合作面板获取

安装

git clone <仓库地址> partner-mcp
cd partner-mcp
pnpm install
pnpm build

构建后，MCP 服务器启动文件位于 packages/mcp/dist/bin.js。

配置

将服务器添加到你的 MCP 客户端配置中。以下 JSON 格式适用于 Claude Desktop、Claude Code 和 Amp：

{
  "mcpServers": {
    "comfy-partner": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js"],
      "env": {
        "COMFY_API_KEY": "comfyui-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

客户端配置文件位置：

客户端	配置文件
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`

配置后重启 MCP 客户端。你应该能在 comfy-partner 服务器下看到注册的 10 个工具。

如需在接入客户端之前验证服务器是否正常启动，可直接运行以下命令——正常情况下会打印 JSON-RPC 握手信息并保持等待：

COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/bin.js

环境变量

变量	必需	说明
`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 助手中尝试以下提示：

生成一张写实风格的太空猫宇航员图片

生成一段海面上日落的短视频

创建一个现代椅子的 3D 模型

生成一段 30 秒左右的 calm lo-fi 风格音乐

官方原文

本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。

内容授权与修改

官方文档采用 GPL-3.0。本站保留许可证、固定提交号和修改说明，不代表 ComfyUI 或 Comfy-Org 对本站背书。

GPL-3.0，来源和修改说明

环境要求

安装

配置

环境变量

可用工具

使用示例

相关文档

官方原文