AI导哈

ComfyUI工作流程管理工具

Comfy Pilot是一款与Claude Code集成的ComfyUI插件，提供可视化终端和工作流自动化管理功能，可直接查看、编辑和运行ComfyUI工作流程。

  • by ConstantineB6
  • Python
  • 本地部署
  • 233 星标
  • 更新于
在 GitHub 查看 ConstantineB6/Comfy-Pilot

使用说明

舒适飞行员

与您的ComfyUI工作流程交谈。Comfy Pilot为Claude Code提供了直接访问权限，可以查看、编辑和运行您的工作流——ComfyUI内部有一个嵌入式终端。

为什么？

构建ComfyUI工作流意味着手动搜索节点、拖动连接和一次调整一个值。使用Comfy Pilot，您只需描述您想要的内容：

  • “使用ControlNet为我构建SDXL工作流” --Claude创建所有节点，连接它们并设置参数
  • “查看输出并增加细节” --Claude看到您生成的图像并调整工作流程
  • “下载FLUX schnell模型并为其设置工作流程” --Claude下载模型并从头开始构建工作流

不复制粘贴节点名称。没有搜索菜单。你想说什么就说什么。

安装

CLI（推荐）：

comfy node install comfy-pilot

ComfyUI管理器：

  1. 打开ComfyUI
  2. 点击 经理 → 安装自定义节点
  3. 搜索“舒适飞行员”
  4. 点击 安装
  5. 重新启动ComfyUI

Git克隆：

cd ~/Documents/ComfyUI/custom_nodes && git clone https://github.com/ConstantineB6/comfy-pilot.git

如果找不到Claude Code CLI，将自动安装。

需求

  • Comfy用户界面
  • Python 3.8+

特性

  • MCP服务器 -允许Claude Code直接访问查看、编辑和运行您的ComfyUI工作流
  • 嵌入式终端 -在ComfyUI中运行Claude Code的完整xterm.js终端
  • 图像查看 -Claude可以看到预览图像和保存图像节点的输出
  • 图形编辑 -以编程方式创建、删除、移动和连接节点

演示

https://github.com/user-attachments/assets/325b1194-2334-48a1-94c3-86effd1fef02

用法

  1. 安装后重新启动ComfyUI
  2. 浮动的Claude Code终端出现在右上角
  3. MCP服务器自动配置为Claude Code
  4. 请Claude帮助您完成工作流程：
    • “我当前的工作流中有哪些节点？”
    • “添加一个连接到我的检查点加载器的KSampler节点”
    • “看看预览图像，告诉我你看到了什么”
    • “将工作流运行到节点5”

MCP工具

MCP服务器为Claude Code提供以下工具：

工具 说明
get_workflow 从浏览器获取当前工作流
summarize_workflow 人类可读的工作流程摘要
get_node_types 使用筛选搜索可用节点类型
get_node_info 获取特定节点类型的详细信息
get_status 队列状态、系统统计信息和执行历史记录
run 运行工作流（可选择运行到特定节点）或中断
edit_graph 批量创建、删除、移动、连接和配置节点
view_image 从“预览图像”/“保存图像”节点查看图像
search_custom_nodes 在ComfyUI管理器注册表中搜索自定义节点
install_custom_node 从注册表安装自定义节点
uninstall_custom_node 卸载自定义节点
update_custom_node 将自定义节点更新到最新版本
download_model 从Hugging Face、CivitAI或直接URL下载模型

示例：创建节点

Create a KSampler and connect it to my checkpoint loader

克劳德将使用 edit_graph 致：

  1. 创建KSampler节点
  2. 将CheckpointLoader的MODEL输出连接到KSampler的模型输入
  3. 将其适当地放置在图表中

示例：查看图像

Look at the preview image and describe what you see

克劳德将使用 view_image 以获取和分析图像输出。

示例：下载模型

Download the FLUX.1 schnell model for me

克劳德将使用 download_model 从Hugging Face下载到您的ComfyUI模型文件夹。支持：

  • 拥抱脸（包括带令牌身份验证的门控模型）
  • CivitAI
  • 直接下载网址

终端控制

  • 拖拽 要移动的标题栏
  • 拖拽 右下角调整大小
  • − 最小化
  • × 关闭
  • ↻ 重新连接会话

建筑

┌─────────────────────────────────────────────────────┐
│  Browser (ComfyUI)                                  │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  xterm.js       │  │  Workflow State          │  │
│  │  Terminal       │  │  (synced to backend)     │  │
│  └────────┬────────┘  └────────────┬─────────────┘  │
│           │ WebSocket              │ REST API       │
└───────────┼────────────────────────┼────────────────┘
            │                        │
            ▼                        ▼
┌─────────────────────────────────────────────────────┐
│  ComfyUI Server                                     │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  PTY Process    │  │  Plugin Endpoints        │  │
│  │  (claude CLI)   │  │  /claude-code/*          │  │
│  └─────────────────┘  └──────────────────────────┘  │
└─────────────────────────────────────────────────────┘
            │                        │
            │                        ▼
            │           ┌──────────────────────────┐
            └──────────▶│  MCP Server              │
                        │  (stdio transport)       │
                        └──────────────────────────┘

文件

  • __init__.py -插件后端：WebSocket终端、REST端点
  • js/claude-code.js -前端：xterm.js终端，工作流同步
  • mcp_server.py -用于Claude Code集成的MCP服务器
  • CLAUDE.md -Claude使用ComfyUI时的说明

故障排除

“未找到命令‘claude’”

安装Claude Code命令行界面：

macOS/Linux/WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）：

irm https://claude.ai/install.ps1 | iex

Windows（CMD）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

MCP服务器未连接

该插件在启动时自动配置MCP。检查ComfyUI控制台是否有错误，或手动添加到 ~/.claude.json:

{
  "mcpServers": {
    "comfyui": {
      "command": "python3",
      "args": ["/path/to/comfy-pilot/mcp_server.py"]
    }
  }
}

终端已断开连接

点击↻ 按钮重新连接，或检查ComfyUI控制台是否有错误。

许可证

麻省理工学院

相关 MCP