> ## 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

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

<Warning>
  **内部测试中 — 尚未公开发布。** Comfy Partner MCP 服务器目前处于内部测试阶段。功能与 API 可能发生变化。访问权限仅限于受邀合作方。
</Warning>

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 合作面板获取

***

## 安装

```bash theme={null}
git clone <仓库地址> partner-mcp
cd partner-mcp
pnpm install
pnpm build
```

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

***

## 配置

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

```json theme={null}
{
  "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 握手信息并保持等待：

```bash theme={null}
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 Cloud MCP](/zh/agent-tools/mcp) — 面向 Comfy Cloud 工作流执行的托管 MCP 服务器
* [Comfy Partner Nodes CLI](/zh/comfy-cli/reference#generate-partner-nodes) — 从命令行使用合作节点