/ 目录 / 演练场 / Comfy Pilot
● 社区 ConstantineB6 🔑 需要你的密钥

Comfy Pilot

作者 ConstantineB6 · ConstantineB6/comfy-pilot

嵌入在ComfyUI中的Claude Code —描述所需的工作流程, Pilot编辑图表,从HuggingFace/CivitAI中获取模型,并安装缺少的节点。

comfy-pilot是一个ComfyUI自定义节点,在ComfyUI内部运行Claude Code —一个嵌入式xterm.js终端,一个MCP服务器,为Claude提供对当前节点图的直接读/写访问权限,预览/保存图像节点的图像分析,以及从HuggingFace/CivitAI/直接URL获取模型或从注册表安装自定义节点的安装程序。询问“使用ControlNet构建SDXL工作流程” ,图表会自行组装,而不是狩猎菜单。

为什么要用

核心特性

实时演示

实际使用效果

comfy-pilot.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "comfy-pilot": {
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ],
      "_inferred": false
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "comfy-pilot",
      "command": "comfy",
      "args": [
        "node",
        "install",
        "comfy-pilot"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "comfy-pilot": {
      "command": {
        "path": "comfy",
        "args": [
          "node",
          "install",
          "comfy-pilot"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add comfy-pilot -- comfy node install comfy-pilot

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Comfy Pilot

从单行描述搭建SDXL工作流程的脚手架

👤 宁愿描述而不愿拖动的ComfyUI用户 ⏱ ~20 min intermediate

何时使用: 您知道您希望工作流程做什么;您不想花20分钟来接线。

前置条件
  • 已安装ComfyUI + comfy-pilot — 舒适节点安装comfy-pilot
  • CLAUDE CODE CLI — Pilot会在缺失时自动安装
步骤
  1. 在ComfyUI中打开试点
    打开Pilot终端,然后说: “使用ControlNet深度调节为我构建一个SDXL文本到图像的工作流。”✓ 已复制
    → 节点图组装;模型缺失则安装
  2. 运行它
    使用prompt = '教堂内部,柔和的光线'和我的深度图运行工作流程。✓ 已复制
    → 已生成图像;已保存工作流程

结果: 无需手动放置20个节点的工作流程。

注意事项
  • 要求飞行员找不到异国情调的模特 — 提供HuggingFace存储库URL或CivitAI ID ;试点下载,以指定者为准
搭配使用: comfyui-mcp-server

重构现有的混乱工作流程

👤 工作流程自然增长的用户 ⏱ ~25 min intermediate

何时使用: 您的图表有60个节点,有一半未使用,您希望它干净。

步骤
  1. 询问清理计划
    分析我当前的图表;列出死节点和冗余分支。✓ 已复制
    → Claude通过MCP阅读图表并制定计划
  2. 确认
    应用—但将“预览图像”节点保留在最后。✓ 已复制
    → 节点已移除;边缘已重新布线;预览完好无损

结果: 更简洁、更易于编辑的工作流程。

注意事项
  • 删除下游自定义代码所依赖的节点 — 在破坏性行动之前让飞行员列表触及节点

自动安装工作流所需的自定义节点

👤 打开第三方工作流程的人员 ⏱ ~10 min beginner

何时使用: 您导入了工作流程, ComfyUI报告缺少自定义节点。

步骤
  1. 要求试点解决
    查找并安装此工作流所需的任何自定义节点。✓ 已复制
    → 试点列出缺少的节点,然后从注册表安装
  2. 验证
    重新加载并确认图表不再有红色边框。✓ 已复制
    → 图形验证干净

结果: 未知工作流程可用,无需对依赖项进行挖掘。

注意事项
  • 大规模安装未知的自定义节点 — 在让Pilot安装数十个包之前,请抽查包源

组合

与其他 MCP 搭配,撬动十倍杠杆

comfy-pilot + comfyui-mcp-server

试点作者工作流程; MCP服务器从其他客户端运行它们

让Pilot构建工作流程,然后通过comfyui-mcp-server从Claude Desktop运行。✓ 已复制
comfy-pilot + filesystem

组织试点创建的资产和工作流程

试点保存工作流后,将其移动到<project>带有日期名称的./workflows//中。✓ 已复制
comfy-pilot + mcp-image

在同一提示上将本地ComfyUI结果与Gemini世代进行比较

通过Pilot的工作流和mcp-image运行相同的提示;差异输出。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
graph.list_nodes / graph.get_node optional filter 阅读当前工作流程 0
graph.create_node / graph.connect type, parent, edges 作者节点和导线边缘 0
image.analyze node_id (Preview/Save) 检查生成的图像以决定下一步 0
model.download source (HF repo, CivitAI id, or URL), target 缺少检查点/LoRA bandwidth
nodes.install custom node package(s) 缺少或自动需要的自定义节点 bandwidth

成本与限制

运行它的成本

API 配额
仅本地计算
每次调用 Token 数
小(图表运算) ;图像/模型字节主导磁盘和带宽
费用
免费;您的GPU +带宽
提示
在下载大型模型捆绑包之前让Pilot确认;许多工作流程共享检查点。

安全

权限、密钥、影响范围

凭据存储: 如果添加HF或CivitAI令牌以获得更高的下载速率,请使用env vars。
数据出站: 从HuggingFace/CivitAI/您授权的直接网址下载;否则为本地网址。

故障排查

常见错误与修复

试点航站楼未开启

通过舒适节点重新安装install comfy-pilot ;确保ComfyUI重新启动。

验证: ComfyUI → Manager → Installed, confirm comfy-pilot listed
企业代理后面的自定义节点安装失败

启动前在ComfyUI进程env中设置HTTPS_PROXY。

验证: env | grep -i proxy in the ComfyUI terminal
模型下载中断

通过重新运行下载来恢复;对于兼容的来源, Pilot会从中断的地方继续。

验证: Re-run model.download with the same target path

替代方案

Comfy Pilot 对比其他方案

替代方案何时用它替代权衡
comfyui-mcp-server您希望从外部MCP客户端运行工作流程,而不是在ComfyUI中创作无嵌入式终端;不同表面
mcp-image与当地的ComfyUI相比,您更喜欢云端双子座更少的控制权;按图像付费
everart您需要预先训练的风格模型不同的提供商

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills