mcp-comfy-ui-builder - 支持知识库与模型管理，ComfyUI工作流构建MCP工具

探索

MCP Comfy Ui Builder

ComfyUI节点发现与工作流构建的MCP服务器，提供知识库、动态工作流构建、实时执行和模型管理工具。

图像与视频处理开发者工具 #AI图像生成 #工作流构建 #节点发现 #实时执行 .TypeScript

评分 : 2分

下载量 : 4.9K

更新时间 : 2026-03-12

打开站点

什么是ComfyUI Builder MCP Server?

这是一个专门为ComfyUI设计的MCP服务器，它允许您通过AI助手（如Cursor或Claude）智能地发现、构建和管理ComfyUI工作流。它包含知识库、节点发现、工作流模板和实时执行功能，让您无需手动编写复杂的JSON工作流。

如何使用ComfyUI Builder?

安装后，在Cursor或Claude Desktop中配置MCP服务器，然后您就可以通过自然语言指令来发现节点、构建工作流、执行图像生成任务。系统会自动处理技术细节，您只需关注创意需求。

适用场景

适合AI图像生成爱好者、设计师、内容创作者以及任何希望简化ComfyUI工作流创建过程的人。特别适合： 1. 快速原型设计 2. 批量图像生成 3. 复杂工作流构建 4. 学习和探索ComfyUI节点功能

主要功能

智能节点发现

内置62个种子节点知识库，可同步到600+个节点。支持节点搜索、兼容性检查和智能建议。

动态工作流构建

无需手动编写JSON，通过自然语言指令即可创建、连接和验证工作流节点。

预置模板系统

提供9个预置模板（txt2img、img2img、inpainting、upscale、LoRA、ControlNet等），快速启动常见任务。

实时WebSocket执行

支持WebSocket实时进度跟踪，提供亚秒级更新，相比轮询减少90%网络流量。

批量与链式执行

支持批量并发执行和顺序链式工作流，可传递数据，提高效率。

资源智能管理

自动检测系统资源（GPU/VRAM/RAM），提供分辨率、模型大小、批处理大小建议，避免内存溢出。

模型管理

支持检查点、LoRA、VAE、ControlNet、upscale、embedding、CLIP等多种模型的管理和检查。

插件系统

数据驱动的插件系统，支持插件列表查看和重新加载。

优势

无需技术背景：通过自然语言即可构建复杂工作流

实时反馈：WebSocket提供亚秒级执行进度更新

智能建议：基于知识库的节点兼容性检查和推荐

资源优化：批量执行减少90%网络流量

开箱即用：内置丰富模板和节点知识库

扩展性强：支持自定义节点和模型安装

局限性

需要ComfyUI环境：必须安装和运行ComfyUI

学习曲线：需要了解基本ComfyUI概念

依赖网络：部分功能需要连接ComfyUI实例

配置复杂：初始MCP服务器配置需要技术操作

如何使用

安装依赖

确保已安装Node.js 18+和ComfyUI。通过npm安装MCP服务器。

构建项目

构建项目以生成知识库和服务器文件。

配置MCP客户端

在Cursor或Claude Desktop中添加MCP服务器配置。需要提供dist/mcp-server.js的绝对路径。

配置环境变量（可选）

如果需要执行工作流，设置COMFYUI_HOST环境变量指向您的ComfyUI实例。

重启客户端

重启Cursor或Claude Desktop以加载新的MCP服务器配置。

开始使用

在聊天界面中，您可以开始使用自然语言指令来构建和管理ComfyUI工作流。

使用案例

快速文本到图像生成

用户想要快速生成一张基于文本描述的图像，无需手动构建复杂的工作流。

图像修复与增强

用户有一张旧照片需要修复和增强，包括去噪、色彩校正和分辨率提升。

风格一致性批量生成

内容创作者需要生成一系列风格一致的社交媒体图片，使用相同的艺术风格但不同的主题。

复杂工作流探索

高级用户想要探索新的ComfyUI节点组合，测试不同的参数设置对输出结果的影响。

常见问题

我需要先安装ComfyUI吗？

为什么MCP服务器启动失败，提示'spawn node ENOENT'错误？

我可以离线使用这个工具吗？

如何更新节点知识库？

支持哪些ComfyUI版本？

我可以创建自定义模板吗？

批量执行有什么优势？

如何避免内存溢出错误？

🚀 mcp-comfy-ui-builder

ComfyUI节点发现 — 为Cursor/Claude提供种子知识库和MCP工具。可通过server.json和mcpName发布到MCP注册表。

🚀 快速开始

安装

npm install mcp-comfy-ui-builder

或者从源代码安装：

git clone https://github.com/MIt9/mcp-comfy-ui-builder.git && cd mcp-comfy-ui-builder && npm install

构建与运行

构建（构建后会从种子填充知识）

npm run build
npm run mcp

在代码中使用知识

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

✨ 主要特性

知识库：从捆绑数据中生成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安装

npm install mcp-comfy-ui-builder

从源代码安装

git clone https://github.com/MIt9/mcp-comfy-ui-builder.git
cd mcp-comfy-ui-builder
npm install

💻 使用示例

基础用法

# 构建项目
npm run build
# 启动MCP服务器
npm run mcp

高级用法

// 在代码中使用知识库
import baseNodes from './knowledge/base-nodes.json' assert { type: 'json' };

📚 详细文档

单一入口点 — 面向任务的导航：

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，下一阶段10（QoL）
贡献：CONTRIBUTING.md
MCP注册表：server.json和package.json中的mcpName；发布npm publish后，可参考MCP注册表快速入门进行发布。

🔧 技术细节

命令说明

命令	描述
`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`之后）

MCP服务器功能

核心功能

节点发现：
- 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，可见性为公开（或私有）。不要使用README、.gitignore或许可证进行初始化（项目已经有这些文件）。
添加远程仓库并推送：

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

如果你分叉了这个仓库，请在上述URL中用你的GitHub用户名替换MIt9。

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