← 返回目录
C

ComfyUI MCP

社区
用自然语言驱动 ComfyUI。
分类
其他 第 106 / 230
Stars
★ 838 非常热门
传输方式
stdio(本地进程) · Streamable HTTP
运行环境
Node.js >=22.0.0 · Python
凭据
无需凭据
许可证
MIT
最近提交
工具数
44
55FMRS · C

这是由 artokun 维护的社区 MCP 服务器和 Claude Code 插件,版本 0.5.0,采用 MIT 许可证。它提供较完整的 ComfyUI 操作、工作流、模型、节点、诊断和进程控制能力,默认使用 stdio,也支持 Streamable HTTP。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 8/20

可靠性
9/20
安全与权限
8/20
维护活跃度
11/20
文档质量
14/20
安装易用性
13/20
查看各项评分依据
可靠性 9/20
README提供了stdio启动、HTTP模式、错误诊断、验证和测试脚本的说明,主流程在静态层面看似可行;但无法核验源代码、CI、实际测试覆盖或初始化/工具列表握手。manifest声称108个工具和29项技能,而README声称181个工具和35项技能,存在未解释的不一致,因此扣分。
安全与权限 8/20
项目默认本地stdio,区分local、remote和cloud模式,并说明API密钥使用位置及部分“不记录”行为;HTTP远程模式支持Bearer/X-API-Key,非回环桥接要求令牌。另一方面,工具可读写本地文件、下载模型、安装自定义节点、控制进程、访问外部API并暴露远程连接;文档没有充分证明最小权限、逐项确认、路径限制或所有危险操作的保护,且远程HTTP默认可通过显式绑定暴露,因此扣分。未见提示中的恶意软件、窃取凭据或隐蔽外泄证据,故不触发红线。
维护活跃度 11/20
MIT许可证、明确的GitHub仓库和维护者、版本号、变更日志入口、贡献指南入口以及测试/构建脚本说明,表明项目具备基本维护路径。静态材料没有提交记录、发行节奏、实际CI、安全响应渠道或依赖更新证据,且无法验证维护者声明,因此只能给中等分数。
文档质量 14/20
README覆盖安装、客户端配置、部署模式、认证变量、传输方式、远程场景、工具分类、示例、故障排查、开发和项目结构,证据面较广。扣分点包括manifest与README的工具/技能数量矛盾、部分能力仅以README声明存在、成本/隐私/权限边界仍不完整,以及无法审查参数实现和限制。
安装易用性 13/20
提供Node.js版本要求、npx一键启动、Claude Code配置示例、stdio与HTTP命令、远程ComfyUI参数和多平台说明,常规本地路径较清晰。仍需预装并运行ComfyUI,Node.js要求较新,模型/自定义节点/凭据和远程网络配置可能带来额外复杂度;没有可验证的CI或端到端安装证据,因此不接近满分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

  • 需要让智能体实际操作 ComfyUI 的用户。
  • 本地 GPU、局域网、VPS、RunPod 或 Comfy Cloud 用户。
  • 需要模型专属生成技能、工作流配方和故障排查的创作者。
  • 使用 Claude Code、Claude Desktop 或支持 MCP 的其他智能体。

不适合谁

  • 只需要转发提示词并返回图像的极简连接场景。
  • 没有 ComfyUI 实例或可访问远程 ComfyUI 的用户。
  • 使用不支持工具调用的模型的用户。
  • 希望获得 Comfy 官方维护或官方云服务保证的用户。

所需权限

  • 需要访问 ComfyUI REST API 和 WebSocket。
  • 本地模式可能需要读写模型目录、输入目录、输出目录和工作流库。
  • 进程控制功能可能启动、停止或重启本地 ComfyUI。
  • 模型搜索和下载可访问 Hugging Face、CivitAI、GitHub 或 ComfyUI Registry;相应功能可能需要令牌。
  • Comfy Cloud 模式需要 COMFYUI_API_KEY。

风险与副作用

  • 执行工作流可能消耗本地 GPU 显存、计算资源和磁盘空间。
  • 下载模型和自定义节点可能引入较大的文件及第三方代码。
  • stop_comfyui、restart_comfyui 和队列操作可能中断任务或未保存的工作流。
  • 远程 HTTP、隧道或桥接部署会扩大网络暴露面,应配置令牌和访问控制。
  • 使用托管 API 节点可能产生付费 API 积分消耗。

安装接入

准备工作

运行环境:Node.js >=22.0.0 · Python

COMFYUI_MCP_BRIDGE_TOKEN 可选密钥 桥接 WebSocket 的共享密钥,非回环绑定时必需。
COMFYUI_API_KEY 可选密钥 Comfy Cloud API 密钥,设置后进入云模式,在 cloud.comfy.org 获取。
COMFYUI_AUTH_TOKEN 可选密钥 自托管 ComfyUI 反向代理的鉴权 token。
CIVITAI_API_TOKEN 可选密钥 CivitAI 下载模型的 API token,在 civitai.com 账户设置中获取。
HUGGINGFACE_TOKEN 可选密钥 HuggingFace token,用于提高下载限速,在 huggingface.co 获取。
GITHUB_TOKEN 可选密钥 GitHub token,生成节点 skill 时避免 API 限流。
REGISTRY_ACCESS_TOKEN 可选密钥 Comfy Registry API key,仅 publish_custom_node 用,env-only。
其他可选配置项(23 个)
COMFYUI_URL 可选 ComfyUI 完整地址,指向本地或远程实例;不设则自动探测。
COMFYUI_HOST 可选 ComfyUI 服务器地址,默认 127.0.0.1。
COMFYUI_PORT 可选 ComfyUI 端口,默认自动探测 8188/8000。
COMFYUI_PATH 可选 ComfyUI 数据目录,自动检测失败时手动指定。
COMFY_CLI_PATH 可选 官方 comfy CLI 可执行文件路径(需 comfy-cli >=1.11.1)。
COMFYUI_PYTHON 可选 依赖安装回退时使用的 Python 解释器,默认 python。
COMFYUI_MCP_BRIDGE_HOST 可选 面板桥接的绑定地址,非回环需配合 token。
COMFYUI_MCP_DATA_DIR 可选 实例数据目录(含 generations.db),默认 ~/.comfyui-mcp。
COMFYUI_CLOUD_URL 可选 覆盖 Comfy Cloud 端点,默认 https://cloud.comfy.org。
COMFYUI_AUTH_HEADER 可选 鉴权头名称,默认 Authorization,可改为 X-API-Key 等。
COMFYUI_AUTH_SCHEME 可选 token 前缀方案,如 Bearer、Token。
COMFYUI_DOWNLOAD_CACHE_DIR 可选 模型下载内容寻址缓存目录,默认 ~/.comfyui-mcp/cache。
COMFYUI_LRU_CACHE_SIZE_GB 可选 下载缓存 LRU 上限(GB),0 表示不淘汰。
COMFYUI_STARTUP_CHECK_INTERVAL_S 可选 启动本地 ComfyUI 时的就绪探测间隔秒数,默认 1。
COMFYUI_ALWAYS_RESTART 可选 本地 ComfyUI 崩溃后是否自动重启,默认 false。
COMFYUI_MCP_STALL_S 可选 渲染卡死看门狗阈值秒数,默认 180(15–3600)。
COMFYUI_MCP_INTERRUPT_S 可选 cancel_job 等待中断的秒数,默认 30。
COMFYUI_MCP_FORCE_REMOTE 可选 设为 1/true 强制远程模式,用于端口转发到 localhost 的远程实例。
COMFYUI_MCP_TOOL_MODE 可选 设为 compact 时只注册 3 个元工具,适合小型/本地模型。
MCP_TRANSPORT 可选 设为 http 时以 streamable-HTTP 提供服务,默认 stdio。
MCP_HOST 可选 HTTP 绑定地址,默认 127.0.0.1。
MCP_PORT 可选 HTTP 端口,默认 9100。
LOG_LEVEL 可选 日志级别:debug/info/warn/error,默认 info。

安装 ComfyUI,并将 server.json 中的 npm 包配置加入 MCP 客户端。Claude Code 可在 ~/.claude/settings.json 的 mcpServers.comfyui 中使用 command 为 npx、args 为 ["-y","comfyui-mcp"]。启动 ComfyUI 后即可用自然语言请求生成或管理工作流。也可运行 npx -y comfyui-mcp@latest --http 使用 Streamable HTTP,或用 --comfyui-url 指向远程实例。

claude_desktop_config.json
{"mcpServers":{"comfyui":{"command":"npx","args":["-y","comfyui-mcp"],"env":{"CIVITAI_API_TOKEN":""}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "comfyui": {
      "command": "npx",
      "args": [
        "-y",
        "comfyui-mcp"
      ],
      "env": {
        "CIVITAI_API_TOKEN": ""
      }
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

Terminal
claude mcp add comfyui -e CIVITAI_API_TOKEN= -- npx -y comfyui-mcp

在终端运行;先把 <…> 占位符换成你自己的值。

验证是否装好

在ComfyUI运行的状态下,在客户端中询问“我的ComfyUI系统统计信息是什么”,若 get_system_stats 工具返回GPU/VRAM信息即说明连接成功。

常见排障

  1. 确认 ComfyUI 正在运行;服务器默认探测 8188 和 8000 端口。
  2. 无法自动发现安装目录时设置 COMFYUI_PATH。
  3. 远程实例使用 --comfyui-url 或 COMFYUI_URL;端口转发场景可使用 --force-remote。
  4. 模型下载失败时检查 HUGGINGFACE_TOKEN 或 CIVITAI_API_TOKEN。
  5. 工作流失败时使用 get_history、get_logs 或 /comfy:debug 检查节点、模型和 Python 错误。
  6. 显存不足时使用 clear_vram,并检查模型所需显存和 VRAM watchdog 警告。
  7. 确认所用模型支持工具调用;思考和视觉能力也被文档列为强烈推荐。

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 画一张夕阳照在山上的图片
  • 把我的VRAM释放一下
  • 用Mermaid把工作流可视化
  • 查一下我装了哪些checkpoint

工具能力 44

generate_image 写入
根据文本提示生成图像并自动构建工作流。
generate_with_controlnet 写入
使用 ControlNet 图像条件和文本提示生成图像。
generate_with_ip_adapter 写入
使用参考图像的风格或主体生成图像。
generate_audio 写入
根据文本提示生成音乐、乐器或音效。
view_image 只读
返回生成资源的内联图像,供智能体查看。
regenerate 写入
重新运行生成资源对应的工作流,可覆盖参数。
list_assets 只读
按时间浏览最近生成的资源。
get_asset_metadata 只读
获取资源的来源、工作流和完整元数据。
展开其余 36 个工具
get_defaults 只读
显示合并后的生成默认值及来源。
set_defaults 写入
更新运行时生成默认值,可持久化到配置文件。
enqueue_workflow 写入
提交 API 格式的工作流并返回任务 ID。
get_job_status 只读
查询任务执行状态。
get_queue 只读
查看正在运行和等待中的任务队列。
cancel_job 破坏性
中断正在运行的任务,并可清除等待任务。
get_system_stats 只读
获取 GPU、显存、Python 版本和操作系统信息。
visualize_workflow 只读
将工作流转换为按类别分组的 Mermaid 流程图。
mermaid_to_workflow 只读
将 Mermaid 图转换为可执行工作流 JSON。
create_workflow 写入
根据模板创建文本生图、图生图、放大、修复等工作流。
modify_workflow 写入
设置输入、增删节点以及连接节点。
get_node_info 只读
查询 ComfyUI 可用节点类型。
validate_workflow 只读
在不执行的情况下检查节点、连接、输出索引和模型文件。
list_workflows 只读
列出 ComfyUI 用户库中的已保存工作流。
get_workflow 只读
按文件名加载已保存的工作流。
strip_workflow 只读
将虚拟连接、重定向节点、子图和旁路节点展开为扁平图。
slice_workflow 只读
从切换模板中提取一个独立的已启用管线。
save_workflow 写入
将工作流保存到 ComfyUI 用户库。
upload_image 写入
将本地图像复制到 ComfyUI 输入目录。
workflow_from_image 只读
从 ComfyUI PNG 元数据中提取工作流。
list_output_images 只读
浏览输出目录中的近期图像和视频。
search_models 只读
搜索 Hugging Face 上的兼容模型。
download_model 写入
将 URL 中的模型下载到正确的 ComfyUI 子目录。
list_local_models 只读
按类型列出本地已安装模型。
clear_vram 写入
通过 ComfyUI 接口释放 GPU 显存。
get_embeddings 只读
列出已安装的文本反演嵌入。
search_custom_nodes 只读
按关键词搜索 ComfyUI Registry 自定义节点包。
get_node_pack_details 只读
获取自定义节点包的描述、作者、节点和安装信息。
generate_node_skill 写入
从 Registry ID 或 GitHub URL 生成节点包技能文档。
get_logs 只读
获取 ComfyUI 日志并支持关键词筛选。
get_history 只读
获取执行历史、错误详情、追踪和计时信息。
stop_comfyui 写入
停止正在运行的 ComfyUI 进程。
start_comfyui 写入
使用保存的信息启动 ComfyUI。
restart_comfyui 写入
保留启动参数并重启 ComfyUI。
suggest_settings 只读
根据本地生成历史建议采样器、调度器、步数和 CFG。
generation_stats 只读
显示本地生成追踪统计。

使用场景

通过文本提示生成图像、视频和音频。
用自然语言创建、修改、验证和执行 ComfyUI 工作流。
搜索、下载和管理模型及自定义节点。
诊断工作流失败并检查日志、历史和显存。
在实时画布中加载、切片和扁平化复杂工作流。

支持客户端

Claude Desktop
Claude Code
MCP Inspector
Hermes部分支持
OpenClaw部分支持
GitHub Copilot CLI部分支持
Ollama部分支持

依据项目文档列出,未经本站实测。

详细介绍

comfyui-mcp 是一个本地优先、面向智能体的 ComfyUI 控制平面,同时提供 MCP 服务器和 Claude Code 插件。它可以生成图像、视频和音频,创建、执行、验证、可视化及修改工作流,管理模型、嵌入、显存和自定义节点,并编辑实时 ComfyUI 图谱。支持本地安装、局域网、VPS、远程 ComfyUI 和 Comfy Cloud。

同类可选方案

BioMCP 75 · B

统一的命令行语法,接入约30个可信生物医学数据源。

★ 659 · 工具数 11 与当前对比 →

源版本 6996d06ff511 数据同步于 2026-10-19 查看 FMRS 评分方法