
今天拆的是 Comfy MCP:Comfy Org 官方给 ComfyUI 做的 MCP 接口,一条托管云连接加一个开源本地服务端,让编码 Agent 自己搜模板、搭工作流、跑渲染、按批取回素材;文章给全它的层级、三条上手路径、七处已知阻塞,以及订阅、积分和商用许可这三笔钱的真实算法。
Comfy MCP 是 Comfy Org 官方给 ComfyUI 做的一套 MCP 接口。接上它,Claude Code、Codex、Cursor 这类客户端里的 Agent 会自己搜模板、搜模型、搜节点,搭出一条工作流交给引擎去跑,再把出好的图、视频和声音取回来。1 它在 2026 年 6 月 29 日进入公开测试,2 分两条路走:一条是托管的云连接,地址 https://cloud.comfy.org/mcp,渲染跑在 Comfy Cloud 的 GPU 上;另一条是开源的本地服务端,pip install comfy-mcp,驱动你自己机器上那台 ComfyUI。3 两条都还在公开测试里,本地那半的仓库用 Python 写,README 顶部写着 40 个工具。4Comfy-Org 组织下面,旧地址 comfyanonymous/ComfyUI 今天会直接跳转过去。6
artokun/comfyui-mcp 是社区先把这件事做出来的那一版:761 star、130 fork、MIT 许可,仓库首页写着 178 个工具、36 个 AI 技能、55 个安装包,它还能起一个侧栏面板,让 Agent 在你正开着的画布上实时改图。16 npm 上这个包过去一周被下载了 34,360 次。17report_issue 工具已经被掏空,只会把你指向官方工具。1618
https://cloud.comfy.org/mcp 加成远程 MCP 服务器或者自定义连接器,浏览器里用 Comfy 账号登录一次就行。Claude Code、Claude Desktop、Codex、OpenClaw 都支持这条 OAuth 流程;Cursor 今天还不支持 MCP OAuth,得在配置里放一个 Comfy Cloud 的 API key,19 没有浏览器的无头和 CI 环境也走 key 这条路。1 官方文档给新用户的建议是从云这条开始,理由是装起来最简单;已经在跑 ComfyUI 的人,或者活儿主要交给编码 Agent 干的人,从本地这条开始。1search_templates、search_models、search_nodes、get_node、cql 等)、生成类 5 个(run_template、submit_workflow、partner_generate、upload_file、apply_slots)、任务与批处理 10 个(wait_for_job、get_output、cancel_job、submit_batch 等)、已保存工作流 5 个、分享 2 个、App 与画布链接 3 个、账户与账单 4 个,合起来 37 个,这是照文档那张表数出来的。1 文档还写了服务器的偏好:先在 comfy.org 的现成模板里找一条对得上的复用,找不到再从零搭图。1comfy-mcp 这个命令当子进程拉起来,通过标准输入输出跟它说话。4 每一次工具调用最后都落到 comfy 命令上(带 --where local),默认打你机器上的 127.0.0.1:8188,也可以用 COMFYUI_URL 指到另一台你控制的机器。4 它跟云那条最实在的差别是「看得见你真实装了什么」:节点、自定义节点、模型文件都从本机现场读,所以它能拿一张图去和现场的 object_info 对账,在你按下运行之前先报缺哪几个文件。14comfy-mcp 这个名字下面的只有 0.9.0(8 月 9 日)和 0.10.0(8 月 10 日)两版,README 里另有一节专门写给从旧包名 comfy-local-mcp 迁过来的人。420 三个口径并存,这里照实列出,不替读者取舍。
src/comfy_mcp、tests、AGENTS.md 和 LICENSE,最近一次提交来自一个 CI 机器人。4comfy-cli 1.14 以上(PyPI 上现在是 1.20.0,GPL-3.0-only),它是每一个工具真正调用的那层引擎。2223comfy install 建一个,已经有检出的话用 comfy set-default <路径> 指过去。4comfy launch 起,或者让 Agent 调 launch_comfyui——服务端不会自己把引擎拉起来。1comfy 这个命令,找不到就用 COMFY_BIN 填绝对路径。4output/ 目录,fetch_outputs 能把某个任务的成品拷到你指定的任何路径。1https://cloud.comfy.org/mcp 加成自定义连接器或远程 MCP 服务器,浏览器里登录。124 在 Claude Code 里还有更短的版本,两条命令装官方那个插件,MCP 连接和一组斜杠命令一起进去:/plugin marketplace add Comfy-Org/comfy-skills,/plugin install comfy-cloud@comfy-skills,然后在 /mcp 里登录。125pip install "comfy-cli>=1.14.0",comfy install 建工作区,comfy launch 把引擎跑起来,pip install comfy-mcp,再把这个命令写进客户端的 MCP 配置。1 验收信号官方给了三个动作:让 Agent 先调 server_info 确认本机 ComfyUI 在哪、在跑什么版本,再让它跑一张工作流 JSON,最后用 fetch_outputs 把图收回来。1
get_output 返回的是一个短时效的临时签名地址,加一条已经拼好的下载命令(macOS 和 Linux 上是 curl,Windows 上是 curl.exe),文档要求原样执行、连签名都不能改;跑不了命令的图形客户端,得自己复制到终端里跑。1 这条被官方列进了自己的「已知限制」:输出需要一步 shell 下载。同一份文档还建议,要上传下载素材的 Claude 用户优先换 Claude Code,用的理由是文件目录的访问能力。1
你能怎么办:把这条链路交给有 shell 的编码 Agent,人只做最后一步确认。comfycomfy 不在 PATH 上;想放到另一台机器上给多人共用,没有 HTTP 入口。
触发条件:服务端装在虚拟环境里,客户端启动时看不到那个环境;或者你想把它做成远程服务。
现状:README 写明这个服务端是 stdio 的,由客户端当子进程拉起;它不把 comfy-cli 声明成依赖,因为要用的是你 PATH 上那个 comfy,找不到时「服务器照常启动、握手照常完成,然后每个工具调用都失败」,这是缺引擎而不是装坏了,COMFY_BIN 就是给这种情况准备的。4 HTTP 传输还是没落地的需求:#273 请求开放 streamable-http(2026-09-15 开,open),28 对应的 PR #248 从 2026-08-20 挂到现在。29
你能怎么办:装完先跑一次 comfy-mcp --version 确认命令在,再把 COMFY_BIN 指向那个 comfy;要远程或多机共用,今天只能用云连接顶着。{"content":[{"type":"text","text":"Error executing tool run_workflow"}],"isError":true},没有错误码、没有提示,客户端分不清是缺模型、服务端挂了还是工作流打错了;同一份报告对照着贴了直接调 comfy 命令的输出,那里 prompt_rejected、unknown_enum_value 和建议值一应俱全,只是没从服务端传出来。30 修这条的 PR #284 在 2026-09-21 挂着。31
你能怎么办:出错时绕开 MCP,自己在终端跑一遍对应的 comfy 命令拿真实报错;或者等那个 PR 合进来。COMFYUI_URL 过时或没设。
现状:#281(2026-09-18 开,open)写的就是 Comfy Desktop 场景下 COMFYUI_URL 过时会静默指向错端口;32 对应的 PR #278 让服务端在没配置时回落到 Comfy Desktop 自己发现的端口(2026-09-18 开,open)。33 同一天前后还有三条方向相反的修法,是让服务端在配了远端目标的时候别去动本地实例,分别是 launch_comfyui、restart_comfyui 和 stop_comfyui。343536 「怎么把它装到 Comfy Desktop 上」这个问法本身也有人提,#258(2026-08-25 开,open)就挂在列表里。37
你能怎么办:把 COMFYUI_URL 显式写成引擎真正在用的地址,或者等那条回落逻辑合进来;用的是 Comfy Desktop 的话,先按它自己报出来的端口配。submit_workflow 用 API 提交,而不是跑现成模板。
现状:文档的「已知限制」一节列了两条相关的——通过 submit_workflow 生成的资产可能不嵌工作流元数据,在 ComfyUI 里打开时不一定能回到原图;工作流的搭建质量取决于模型准确度,复杂图可能要重试或追加修改。1
你能怎么办:优先用 run_template 在现成模板上改参数,把搭图的自由度收小一点;跑通的图用 save_workflow 存进账号,update_workflow 按新版本保存,旧版本还能找回。1
| 方案 | 你给它什么 | 它给你什么 | 它在这一层 | 许可与公开体量 |
|---|---|---|---|---|
| 本期:Comfy MCP | 一个 Comfy 账号,或一台装着 Python、comfy-cli 和 ComfyUI 的机器 | Agent 自己建图、跑渲染、批量出素材,工作流存得下也分享得出去 | 生成引擎的 Agent 接口,云与本地两条连接 | 本地服务端双许可(AGPL-3.0-or-later 或商用),234 star4 |
| 上一代:comfyui-mcp(已归档) | 同样一台机器,外加一个装好的侧栏面板 | 178 个工具、36 个技能、55 个安装包,能在活着的画布上实时改图 | 同一层的社区版本 | MIT,761 star,2026-10-09 归档16 |
| Nomi | 一台 macOS / Windows 机器,一份你自己的模型来源 | 一份本地工程:画布、分镜、时间线、MP4 导出 | 本机工作台,自带编辑器,模型从外部接 | AGPL-3.0,520 star15 |
| DaVinci Resolve MCP | 一台装着 Resolve 的机器、开着的 Resolve 界面 | 37 个(默认)或 389 个 MCP 工具,覆盖 361 个脚本 API 方法 | 给已装好的专业 NLE 装 Agent 接口 | MIT,3,075 star14 |
| FireRed-OpenStoryline | 一份 config.toml 和几个模型 key | 18 个工具节点串起的成片产线 | 自带 Agent 的成片流水线 | Apache-2.0,3,433 star10 |
| FableCut | 一个浏览器 | 一条 JSON 时间线和 MCP / REST 入口 | 自带编辑器的浏览器端 | MIT,687 star9 |
| kinocut | FFmpeg 和 Python 环境 | 196 个 MCP 工具与一张渲染回执 | FFmpeg 的执行与验证层 | Apache-2.0,163 star8 |
| video-use | 一堆原始素材和转写额度 | 读着词级转写稿剪出的 final.mp4 | 装进编码 Agent 的剪辑技能包 | MIT,25,813 star11 |
| video-shotcraft | 一条模板指令 | 157 张镜头配方卡排出的宣传片 | 镜头与素材资产库 | Apache-2.0,9,238 star12 |
| OpenMontage | 一个编码 Agent | 12 条视频管线跑到 final.mp4 | 编排层 | AGPL-3.0,60,913 star13 |
| HyperFrames | HTML 和组件代码 | 浏览器里的渲染底座 | 渲染底座 | Apache-2.0,52,392 star41 |
| hypit | 一份需求描述 | 一条从脚本到成片的流程 | 编排层 | 自订许可,13,848 star42 |
docs.comfy.org
blog.comfy.org
github.com
github.com
github.com
comfy.org
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
npmjs.com
comfyui-mcp.artokun.io
platform.comfy.org
pypi.org
cloud.comfy.org
pypi.org
github.com
comfy.org
github.com
docs.comfy.org
comfy.org
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
github.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.