适合谁
- 本机拥有可承载本地扩散推理硬件的用户（独显 ≥ 24GB 显存最适合，Apple Silicon ≥ 32GB 统一内存可做图像）
- 希望用 Claude Code、Claude Desktop、Cursor 等 MCP 客户端自动化本地 ComfyUI 工作流的用户
- 需要按实时安装情况（含自定义节点）检索节点、模型与模板的用户
- 在本地同时运行 LLM 与 ComfyUI、需要显存协调读取与释放的用户
C
69FMRS · C
Comfy MCP 是 Comfy-Org 官方维护的本地 MCP 服务器，基于 comfy-cli 构建，通过 stdio 由客户端以子进程方式驱动你自己机器上的 ComfyUI，覆盖生成、任务监控、输出收集、实时检索本机节点/模型/模板、工作流校验与管理。它本地优先但并非仅限本地：合作方模型可在合作方基础设施上运行，COMFYUI_URL 也可指向你控制的另一台机器。它没有通往 Comfy Cloud 的路径，需要云端 GPU 执行的场景应使用另外的远程 HTTP 服务器。要求 Python ≥ 3.10 与 comfy-cli ≥ 1.14.0，当前为 beta 状态、约 40 个工具。适合有本地推理硬件、希望通过 AI 客户端自动化本地 ComfyUI 的用户；消费积分、网络暴露与本地环境修改是主要风险点，均有确认门槛但需谨慎授权。
Comfy MCP 是由 Comfy-Org 维护、基于 comfy-cli 构建的本地 MCP 服务器，通过 stdio 由 AI 客户端以子进程方式启动，用来驱动你自己机器上安装的 ComfyUI（默认 127.0.0.1:8188，也可通过 COMFYUI_URL / COMFYUI_HOST 指向你控制的另一台机器）。它提供生成图像、异步提交与监控任务、查看失败原因、收集输出 PNG、检索本机实际安装的节点/模型/模板、校验与编辑工作流、以及启动/停止/重启 ComfyUI 和查看日志等能力。所有工具都以 --where local --json 调用 comfy 命令并解析 comfy-cli 的 envelope/1 输出。要求 Python ≥ 3.10、comfy-cli ≥ 1.14.0、一个 ComfyUI 工作区以及已启动的 ComfyUI。当前为 beta 状态，共 40 个工具。注意：它没有通往 Comfy Cloud 的路径，云端执行请使用另外的远程 HTTP 服务器 https://cloud.comfy.org/mcp。
工具能力
server_info
确认本地 ComfyUI 是否运行，并报告工作区、Python 环境、hardware 与 freshness 等信息
run_workflow
执行工作流 JSON（API 格式或 UI 导出），可选异步提交后等待、观察或取消
generate_image
文本提示词一步生成图像，运行图库默认的文本到图像模板
run_template
运行图库模板，付费模板需要 confirm_spend 授权
fetch_outputs
按 prompt_id 收集已完成任务的输出文件，并可复制到指定目录
job
查看任务状态、队列、等待或取消等任务操作
search_templates
搜索图库模板，可按标签与类型过滤
fetch_template
获取模板并写出可运行的工作流 JSON，附带 local_check 兼容性检查
get_template
读取模板内容并附带 local_check 兼容性检查
search_models
搜索可用模型，包含跨文件夹查找
download_model
下载模型到本机模型目录；配置远程 ComfyUI 时会拒绝，除非声明共享存储
download
管理已提交的下载任务及其状态
upload_file
将本机文件作为输入资源上传到目标 ComfyUI
nodes
检索实时 ComfyUI 中的节点信息，包含自定义节点
node_dependencies
查看节点依赖
validate_workflow
校验工作流图是否可在当前安装上运行
list_workflow_notes
列出工作流备注
system_stats
读取实时 ComfyUI 的每设备显存空闲/总量，用于显存协调
free_memory
请求 ComfyUI 释放其已加载的模型显存
launch_comfyui
启动 ComfyUI 服务，使用 --listen 时会请求确认
stop_comfyui
停止 ComfyUI 服务
restart_comfyui
重启 ComfyUI 服务；需停止非本服务器启动的服务时会请求确认
update_comfyui
更新 ComfyUI，target=all 时会请求确认
switch_comfyui_version
切换 ComfyUI 版本，会请求确认
install_node
安装节点包，会请求确认
get_logs
查看本地 ComfyUI 日志
auth_login
后台启动登录流程并返回 OAuth 链接，用于 Comfy 凭据授权
auth_status
确认登录状态
partner_generate
调用托管合作方模型生成内容，会消耗 Comfy 积分，每次调用都需确认
emit_partner_workflow
仅写出包含合作方 API 节点的工作流图，不调用合作方、不消耗积分
安装接入
- 安装组件：pip install comfy-mcp "comfy-cli>=1.14.0"，如无工作区再执行 comfy install（注意安装 comfy-mcp 不会自动安装 comfy-cli）。2. 启动并保持运行 ComfyUI：comfy launch。3. 在 AI 客户端中注册该服务器，command 为 comfy-mcp，按需在 env 中设置 COMFY_BIN（comfy 可执行文件绝对路径）、COMFY_API_KEY（仅合作方 API 节点需要）等；Claude Code 可用 claude mcp add comfy-mcp -e COMFY_BIN=... -- comfy-mcp。4. 重启或重载客户端，让工具出现，然后让智能体先调用 server_info 确认 ComfyUI 在运行，再执行 run_workflow / fetch_outputs。
claude_desktop_config.json
{
"mcpServers": {
"comfy-mcp": {
"command": "comfy-mcp",
"env": {
"COMFY_BIN": "/path/to/venv/bin/comfy",
"COMFY_API_KEY": "<your-comfy-api-key>"
}
}
}
}
选型与风险
不适合谁
- 希望使用 Comfy Cloud 云端 GPU 执行、云端队列或跨会话云端批次的用户（本服务器没有通往 Comfy Cloud 的路径，应改用 https://cloud.comfy.org/mcp）
- 显存低于 8GB 或确认没有 GPU 的机器（应改用合作方节点或云端 MCP）
- 需要在非本机服务器上管理生命周期（启动/停止/更新/切版本/装节点/看日志）的用户，这些工具仅限本地
- 运行在远程或容器化 MCP 上、需要在本机浏览器完成登录回调的用户
所需权限
- 以子进程方式在用户本机运行 comfy 命令，命令携带服务器进程的完整环境
- 读取 ComfyUI 工作区文件，包括工作流 JSON 与 input 资源
- 写入生成结果，默认写入 ComfyUI 工作区的 output/ 目录，fetch_outputs 可复制到你指定的目录
- 在本机写入/安装模型与节点包（download_model、install_node）
- 读取、启动、停止或重启本地 ComfyUI 进程
- launch_comfyui 使用 --listen 会将未认证的 ComfyUI 暴露到网络，需显式确认
- COMFY_API_KEY 用于合作方 API 节点，会通过这些节点消耗 Comfy 积分
- 可通过 COMFY_MCP_ASSUME_CONSENT 预授权 install_node、update_all、version_switch、kill_untracked、network_exposure 等确认门槛（不包含消费积分）
风险与副作用
- 合作方模型生成（partner_generate、含合作方 API 节点的工作流或模板）会真实消耗 Comfy 积分，需在调用时确认；不可仅凭“始终允许该工具”视为消费同意
- 任意自定义节点仍可能自行调用付费服务，confirm_spend 门槛只覆盖 comfy-cli 能识别的合作方 API 节点，未自行构建的工作流应先检查内容再运行
- launch_comfyui 使用 --listen 会把未认证的 ComfyUI 暴露到网络，存在被他人访问的风险
- 安装节点包、切换版本、更新 ComfyUI、强制重启非本服务器启动的服务会修改本机环境，客户端若不展示确认提示则工具会失败关闭
- 配置远程 COMFYUI_URL 时，system_stats / free_memory 等工具仍作用于本地安装，可能测量和释放错误的机器；远程 ComfyUI 需在该网络内可访问且未认证
- COMFY_MCP_ASSUME_CONSENT 预授权是写在客户端配置中的设置，授权范围不当可能放大上述风险
- 本服务器为 beta 状态，行为可能变化
常见排障
- 工具调用报 “comfy not found on PATH”：说明缺少引擎而非安装损坏，请安装 comfy-cli ≥ 1.14.0，或在客户端 env 中通过 COMFY_BIN 指定 comfy 的绝对路径
- 报 comfy-cli 版本过旧：本服务器要求 ≥ 1.14.0，安装该服务器本身不会安装 comfy-cli，需一并安装或升级
- 确认 COMFY_LOCAL_URL 是否生效：先调用 server_info（它包装 comfy env），若仍显示 :8188，检查变量是否放在正确的 env 块、客户端是否重启、值是否合法（仅接受 http）、以及 comfy-cli 版本；可在终端运行 COMFY_LOCAL_URL=<值> comfy env 查看 stderr 警告
- 失败日志未产生：COMFY_LOCAL_MCP_DEBUG_LOG 已不再读取，应改用 COMFY_MCP_DEBUG_LOG；从 comfy-local-mcp 升级时默认日志目录叶节点也已改为 comfy-mcp/
- macOS 上出现 Operation not permitted：ComfyUI 不要放在 ~/Documents、~/Desktop、~/Downloads，或为客户端授予完全磁盘访问权限
- 模板运行失败但检索正常：查看 local_check 块，runnable=false 表示缺少节点类或模型选项，checked=false 通常是因为 ComfyUI 未运行、没有实时目录可比较
- 合作方节点运行失败且提示 partner_node_requires_credential：需要设置 COMFY_API_KEY，或用 auth_login 完成登录，也可用 comfy auth set comfy-cloud-api-key --key <KEY> 存储密钥（MCP 客户端不会继承你交互式 shell 的 COMFY_API_KEY）
- 客户端不展示确认提示：工具会失败关闭并给出可替代执行的终端命令，可改用 COMFY_MCP_ASSUME_CONSENT 预授权相应门槛
- 无法从 comfy-local-mcp 升级：需先 pip uninstall comfy-local-mcp 再安装 comfy-mcp，并把客户端配置中 command 改为 comfy-mcp，避免 PATH 上残留指向旧包的脚本
使用场景
让 AI 智能体在本机 ComfyUI 上运行已有工作流并回收生成的图片
从文本提示词一步生成图像
异步提交任务后进行等待、观察、取消并查看失败原因
检索本机实际安装的节点、模型和模板，而不是静态目录
校验工作流图、编辑模板槽位并派生多个变体
管理本地 ComfyUI 的启动、停止、重启、日志和输入资源上传
支持客户端
Claude Code完整支持
Claude Desktop完整支持
Cursor完整支持