跳转到主要内容

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_KEYAPI 密钥(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 风格音乐

相关文档