mcpField
C
comfy

comfy

github.com/comfy-org创意与媒体23984 次安装6 天前更新
代码仓库

关于 comfy

Comfy Cloud 将 Agent 连接到托管的 ComfyUI，用于生成媒体和编写工作流。它支持合作方模型与开源管线，并提供 OAuth 或 API 密钥认证。

主要功能

  1. 01生成图像、视频、音频和 3D 内容
  2. 02搜索模板和模型资源
  3. 03运行并保存自定义工作流
  4. 04管理任务并获取输出
  5. 05批量提交多个变体

适用场景

  1. 01使用指定模型生成媒体
  2. 02运行基于模板的开源管线
  3. 03上传图像并进行编辑
  4. 04通过批处理创建多个变体

MCP 相关

它连接到托管的 Comfy Cloud MCP 服务，地址为 `https://cloud.comfy.org/mcp`。MCP 客户端可使用其生成、发现、工作流和任务管理工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/comfy-org/comfy-skills --skill comfy

安装后在 Claude Code 中输入/comfy确认已加载。

详细介绍

Comfy Cloud

Comfy Cloud 在云端运行 ComfyUI，并将其作为 MCP 服务提供给 Agent：通过合作伙伴模型（Ideogram、Flux、Kling、Veo、Seedance 等）和开源工作流生成图像/视频/音频/3D 内容， 还支持完整的 ComfyUI 工作流编写——搜索模板、覆盖输入、提交自定义图，以及获取输出的签名 URL。

范围：此技能连接托管的 Comfy Cloud MCP 服务，并且需要 Comfy 账户——它不会驱动本地 ComfyUI 安装。面向本地 ComfyUI 的 MCP 已列入路线图，将作为单独的技能发布；在此之前，本地实例请参阅 comfy-cli。

连接

该服务支持两种身份验证方式：OAuth（通过浏览器登录，无需管理密钥——推荐）和 API 密钥（适用于无头或 CI 环境）。

选项 A — OAuth（推荐）
openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login comfy
openclaw gateway restart

openclaw mcp login 会打印授权 URL——打开它，登录 Comfy 账户，并按 CLI 的指示完成流程（它可能会要求你使用 --code <code> 重新运行）。使用 openclaw mcp status --verbose 验证。请注意，一旦设置了 auth: "oauth"，OpenClaw 就会忽略服务条目中的静态 headers，因此不要同时配置两者。

选项 B — API 密钥（无头 / CI）

  1. 获取 API 密钥 — 在 cloud.comfy.org 登录，然后在 Settings → API Keys 下创建密钥。密钥以 comfyui- 开头。

  2. 导出密钥（将其添加到 shell 配置文件或 OpenClaw 的环境变量中）：

    export COMFY_API_KEY="comfyui-..."

  3. 向 OpenClaw 注册 MCP 服务：

    openclaw mcp set comfy '{"url":"https://cloud.comfy.org/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${COMFY_API_KEY}"}}'
openclaw gateway restart

    服务也接受通过 X-API-Key: ${COMFY_API_KEY} 标头传入密钥，但建议使用上面的 Authorization: Bearer 形式——标准标头在每个客户端的代理层中都能保留，而且某些 OpenClaw 构建版本会在 streamable-http 传输中丢弃自定义标头（参见 openclaw#65590）。如果使用确定有效的密钥却收到 401，很可能就是遇到了这个问题：切换到 Bearer 形式、通过 mcporter 路由，或者直接使用 OAuth（选项 A）。

无论哪种方式：浏览/搜索工具都可用于任何账户；生成内容会消耗 Comfy Cloud 积分，并且需要订阅或积分余额。

使用哪些工具

使用指定模型生成图像和视频（Ideogram、Flux、Gemini、Kling、Veo、 Seedance，等等）：调用 partner_generate 前，先检查指定模型系列是否也有 OSS 途径——有些系列（截至 2026-08，MiniMax H3 是一个近期示例）会以完全相同的显示名称同时提供收费合作伙伴节点和开源权重。针对该系列同时运行 search_templates 和 search_nodes；如果两者都有结果，告知用户存在 OSS 选项（它不收取合作伙伴/API 费用，但运行仍会消耗 Comfy Cloud 的常规计算点数——在 Comfy Cloud 上并非免费，只是不收取合作伙伴附加费），并询问用户想选哪种。如果只有合作伙伴途径，或用户选择付费途径，则调用 partner_generate——它会通过 Comfy Cloud 运行服务提供商，并将结果保存到你的素材库。用户指定了合作伙伴模型时，不要为纯文本生成图像/视频手动搭建工作流。

任何工作流类型的任务（开源模型、LoRA/ControlNet、多步流水线）：从模板开始——search_templates → get_template_schema → 使用 input_overrides 调用 run_template。对于完全自定义的图结构，使用 submit_workflow（图必须以 SaveImage 之类的输出节点结尾，否则验证会拒绝）。使用 save_workflow / run_saved_workflow 保存并复用。

编辑现有图像：先调用 upload_file，然后从 LoadImage 节点引用已上传的文件（或者将文件传给支持图生图的合作伙伴的 partner_generate）。切勿将 base64 图像数据直接写入工作流。

获取结果：wait_for_job → get_output。输出会以有时效限制的签名 URL 返回——请按原样下载（不要修改查询参数，它们是签名的一部分）。使用 get_queue 和 cancel_job 管理进行中的任务；使用 submit_batch / wait_for_batch 批量生成多个变体。

发现：search_models（平台上的检查点/LoRA）、search_nodes（可用的 ComfyUI 节点及其连线提示）、get_prompting_guide（针对特定模型的提示建议）。

示例提示词

  • “使用 Ideogram 生成一张雨天下午温馨书店咖啡馆的图像，并下载到 ./bookstore.png”
  • “处理 ./product.jpg，移除背景，并将结果放大 2×”
  • “查找 Kling 的文生视频模板，使用提示词 ‘一艘纸船沿雨水槽漂流，电影感’，运行模板并给我输出 URL”

备注

  • 生成会消耗 Comfy Cloud 点数；搜索/发现工具免费。
  • 完整 MCP 文档和各客户端的设置说明：docs.comfy.org/cloud/mcp

评论

支持 Markdown