跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.comfy.org/llms.txt

Use this file to discover all available pages before exploring further.

预览版 — 需要等候名单。 Comfy Partner MCP 服务器目前为预览版。功能与 API 可能发生变化。
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
Amp设置 → MCP 服务器，或 ~/.config/amp/settings.json
配置后重启 MCP 客户端。你应该能在 comfy-partner 服务器下看到注册的工具。

​
环境变量

变量必需说明
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 内容块。

​
可用工具

MCP 服务器提供所有主流生成类型的工具：
工具说明
generate_image从文字提示生成图片
generate_video从文字或图片生成视频
generate_3d生成 3D 模型（GLB/FBX/OBJ）
generate_svg生成 SVG 矢量图形
generate_audio生成语音或音效
generate_music生成音乐曲目
models_explore搜索和浏览可用模型
balance查看账户余额
regions查看可用生成区域

​
使用示例

安装后在 AI 助手中尝试以下提示： 
生成一张写实风格的太空猫宇航员图片

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

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

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

​
相关文档