Documentation Index
Fetch the complete documentation index at: https://dripart-docs-cloud-mcp-partner-generate-oauth.mintlify.app/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(或运行 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 助手中尝试以下提示:
生成一段 30 秒左右的 calm lo-fi 风格音乐
相关文档