ComfyUI Builder

Name: ComfyUI Builder
Author: MIt9

本地服务

github.com/MIt9媒体与设计54 天前更新

代码仓库

关于 ComfyUI Builder

ComfyUI Builder 是供兼容 AI 客户端控制 ComfyUI 的 MCP 服务。工具涵盖节点发现、工作流构建、实时进度执行和模型管理，并提供可复用模板与宏。

主要功能

01发现并查看 ComfyUI 节点
02动态构建并验证工作流
03使用模板和可复用宏
04通过 WebSocket 跟踪执行进度
05管理模型、输出和队列
06安装自定义节点与模型

适用场景

01根据需求构建图像生成工作流
02组合工作流前检查节点兼容性
03跟踪工作流执行进度
04管理模型并获取生成结果

MCP 相关

该 MCP 服务向 MCP 客户端提供 50 多种工具，用于 ComfyUI 节点发现、工作流构建与执行、模型管理及相关操作。它通过 stdio 通信，并在可用时使用 WebSocket 推送进度，连接不可用时回退到轮询。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mit9-comfy-ui-builder": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-comfy-ui-builder"
      ],
      "env": {
        "COMFYUI_HOST": "<COMFYUI_HOST>",
        "COMFYUI_PATH": "<COMFYUI_PATH>",
        "COMFYUI_KNOWLEDGE_DIR": "<COMFYUI_KNOWLEDGE_DIR>"
      }
    }
  }
}

启动命令npx -y mcp-comfy-ui-builder

需要配置的环境变量

COMFYUI_HOSTComfyUI API URL (e.g. http://127.0.0.1:8188). Required for execution, queue, outputs.

COMFYUI_PATHPath to ComfyUI install. Required for install_custom_node, install_model.

COMFYUI_KNOWLEDGE_DIRPath to knowledge directory (default: package knowledge/). Use when MCP runs from different cwd.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-comfy-ui-builder2.4.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-comfy-ui-builder

通过 Claude 或 Cursor 控制 ComfyUI——提供 50 多种 MCP 工具，用于发现节点、动态构建工作流、通过 WebSocket 实时执行和管理模型。无需编辑 JSON。

告诉你的 AI 助手要生成什么图像，它就会为你构建并运行 ComfyUI 工作流。
兼容 Claude Desktop、Cursor 和任何兼容 MCP 的客户端。

可通过 server.json 和 mcpName 发布到 MCP Registry。

这是什么

知识库： 使用捆绑数据填充 knowledge/base-nodes.json 和 node-compatibility.json（62 个种子节点；同步后为 100–600 多个）。建议和构建无需外部服务。
同步： 从 ComfyUI-Manager 获取自定义包；通过 sync-nodes CLI 或在 MCP 启动时，从运行中的 ComfyUI 获取节点。
MCP 服务（50 多种工具）： 节点发现、动态工作流构建器、9 个模板（txt2img、txt2img_flux、img2img，等等）、WebSocket 实时执行、批处理/链式执行、模型管理、插件系统。
实时执行： 通过 WebSocket 实现亚秒级进度更新，并在必要时自动回退到轮询；批量运行的网络流量约减少 90%。

安装

npm install mcp-comfy-ui-builder

或从源代码安装：git clone https://github.com/MIt9/mcp-comfy-ui-builder.git && cd mcp-comfy-ui-builder && npm install

快速开始

构建（postbuild 会使用种子数据填充知识库）
```
npm run build
npm run mcp
```

在代码中使用知识库

import baseNodes from './knowledge/base-nodes.json' assert { type: 'json' };

命令

命令	说明
`npm run seed`	使用种子数据填充知识库。使用 `--force` 覆盖。
`npm run sync-manager`	从 ComfyUI-Manager 更新自定义包列表
`npm run sync-nodes`	将运行中的 ComfyUI 节点同步到知识库（需要 COMFYUI_HOST）
`npm test`	运行测试（vitest）
`npm run mcp`	启动 MCP 服务（需先运行 `npm run build`）

文档

统一入口——按任务导航：

doc/README.md — 从何处开始，按任务导航
doc/INDEX.md — 文档和链接完整列表
doc/QUICK-REFERENCE.md — 命令、示例、故障排除
doc/GETTING-STARTED.md — 快速开始
doc/MCP-SETUP.md — 在 Cursor/Claude 中连接 MCP
doc/DOCKER-SETUP.md — docker pull siniidrozd/mcp-comfy-ui-builder | MCP + ComfyUI 的 docker-compose
知识库： knowledge/README.md、doc/knowledge-base-usage-guide.md
工作流构建器： doc/workflow-builder.md — 模板、参数、保存/加载、ComfyUI 格式
规划： ROADMAP.md、NEXT-STEPS.md、TODO.md — 当前为 v2.3.x，下一阶段为 Phase 10（QoL）
贡献： CONTRIBUTING.md
MCP Registry： server.json 和 package.json 中的 mcpName；发布请参阅 MCP Registry 快速入门，并在 npm publish 后进行发布。

要求

Node.js 18+

MCP 服务（Cursor / Claude）

服务提供 9 个类别的 50 多种工具：

核心功能

节点发现：

list_node_types、get_node_info、check_compatibility、suggest_nodes
discover_nodes_live、search_nodes、sync_nodes_to_knowledge

动态工作流构建器：

create_workflow、add_node、connect_nodes、validate_workflow
以编程方式构建工作流，无需操作 JSON

模板与宏：

list_templates、build_workflow — 预构建模板（txt2img、img2img、inpainting、upscale、LoRA、ControlNet、batch）
create_template、apply_template — 参数化模板
list_macros、insert_macro — 可复用的子工作流

实时执行 📡

execute_workflow_sync — 执行并通过 WebSocket 流式传输进度（亚秒级更新）
execute_workflow_stream — 收集完整事件历史（仅限 WebSocket）
get_execution_progress — 提供节点级粒度的实时进度
execute_batch — 并发执行，网络流量减少 90%
execute_chain — 按顺序执行工作流并传递数据

资源与模型管理：

get_system_resources — GPU/VRAM/RAM 和建议（最大分辨率、模型大小、批次大小）；为避免 OOM，构建工作流前应先调用
list_models、check_model_exists、get_workflow_models
支持 checkpoint、lora、vae、controlnet、upscale、embedding、clip

输出与队列：

list_outputs、download_output、download_all_outputs
list_queue、interrupt_execution、clear_queue

插件：

list_plugins、reload_plugins — 纯数据插件系统

安装（需要 COMFYUI_PATH）：

install_custom_node、install_model — 通过 ComfyUI-Manager 安装节点和模型

WebSocket 功能

进度更新延迟 <100ms（轮询为 1.5s）
**节点级跟踪：**准确查看正在执行的节点及其进度百分比
**自动回退：**WebSocket 不可用时，自动平稳切换到轮询
**共享连接：**批处理/链式执行共用单个 WebSocket（网络流量减少 90%）

设置 COMFYUI_HOST 环境变量以供执行/模型/输出工具使用：

export COMFYUI_HOST="http://localhost:8188"

有关完整工具列表，请参阅 doc/MCP-SETUP.md；有关实时功能，请参阅 doc/WEBSOCKET-GUIDE.md。

运行 MCP

在项目根目录中，先构建项目，然后启动服务：

npm run build
npm run mcp

也可以不使用 npm：node dist/mcp-server.js。服务通过 stdio（stdin/stdout）运行。更多详情 → doc/MCP-SETUP.md。

连接 MCP（Cursor / Claude）

所需条件：Node.js 18+、一次性构建（npm run build）、dist/mcp-server.js 的绝对路径，以及配置更改后重启。如果服务因 «spawn node ENOENT» 而无法启动，请在 command 中使用 node 的完整路径（运行 which node 并填入该路径）。请参阅 doc/MCP-SETUP.md → 故障排除。

最简配置（仅知识库和工作流工具）：

{
  "mcpServers": {
    "comfy-ui-builder": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-comfy-ui-builder/dist/mcp-server.js"]
    }
  }
}

如果 Cursor/IDE 提示 «spawn node ENOENT»，请在 command 中使用完整路径（例如 "/opt/homebrew/bin/node"）。

使用 ComfyUI 执行（execute_workflow、get_execution_status、list_outputs 等）：在服务配置块中添加 "env": { "COMFYUI_HOST": "http://127.0.0.1:8188" }。有关完整检查清单、可选环境变量（COMFYUI_PATH、COMFYUI_KNOWLEDGE_DIR）和故障排除，请参阅 doc/MCP-SETUP.md。

在 GitHub 上发布

在 GitHub 上创建一个新仓库：名称为 mcp-comfy-ui-builder，可见性设为 Public（或 Private）。不要使用 README、.gitignore 或 license 进行初始化（项目中已包含这些文件）。

添加远程仓库并推送：

git remote add origin https://github.com/MIt9/mcp-comfy-ui-builder.git
git branch -M main
git push -u origin main

如果你 fork 了此仓库，请将上方 URL 中的 MIt9 替换为你的 GitHub 用户名。

Cursor： Settings → MCP；Claude Desktop： 配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）。将路径替换为 dist/mcp-server.js 的绝对路径，然后重启应用。完整指南：doc/MCP-SETUP.md。

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。