comfyui-mcp：讓 MCP 工具直接操作 ComfyUI 工作流
ComfyUI 的本地優先、代理本機控制平面、MCP 伺服器 + Claude Code 插件。 108 工具，29 個 AI 技能（Flux WAN LT2.3 Qwen Ideogram4 Krea2）。創作和運行工作流程、用自然語言編輯即時圖表、管理模型和自訂節點。本地、LAN、VPS 或舒適雲。
秒懂
- 它是什麼？
- 這是一個 TypeScript MCP 服務器與 ComfyUI 侧边栏代理，借助 REST、WebSocket、模型設定和提供商適配器完成工作流控製。 聚焦本專案的實際功能、技術入口、部署條件、資料流、版本變化與授權邊界，並依官方 README 所列能力判斷適用工作情境和不適合的替代用途。
- 適合誰用？
- 適合已经執行 ComfyUI、希望用自然語言管理工作流的創作者和開發者，不適合把远程連接、模型下載和 Agent 操作直接開放到不受控網絡。先启動本地 ComfyUI，使用預設 8188 端口跑一個可回滚工作流，檢查 REST/WebSocket 日志、模型缓存和 COMFYUI_URL 或 API key 的數據边界。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 2 天前。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
artokun-comfyui-mcp-deep-analysis｜面向 ComfyUI 的控製平面 · artokun-comfyui-mcp-deep-analysis
artokun-comfyui-mcp-deep-analysis｜面向 ComfyUI 的控製平面 · artokun-comfyui-mcp-deep-analysis 的專案脈絡：comfyui-mcp 是一個 TypeScript 項目，將 MCP 服務器與 ComfyUI 的侧边栏代理配對。README 將其描述為本地優先、代理原生的控製平面：它可以生成图像、视頻和音頻，编寫並執行工作流，管理模型和自定義节点，並通過自然語言编辑實時 ComfyUI 图形。該服務器支援 macOS、Linux 和 Windows，並能自動检測 ComfyUI 的安裝位置和端口。倉庫元數據列出 496 個星標和 84 個 fork，項目采用 MIT 許可證。
專案核對 0：請在 artokun-comfyui-mcp-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
artokun-comfyui-mcp-deep-analysis 第 1 節的具體核對點是 artokun-comfyui-mcp-deep-analysis｜面向 ComfyUI 的控製平面 · artokun-comfyui-mcp-deep-analysis。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
artokun-comfyui-mcp-deep-analysis｜服務器如何發現並與 ComfyUI 通信 · artokun-comfyui-mcp-deep-analysis
artokun-comfyui-mcp-deep-analysis｜服務器如何發現並與 ComfyUI 通信 · artokun-comfyui-mcp-deep-analysis 的專案脈絡：服務器通過 ComfyUI 的 REST API 和 WebSocket 接口與之通信。預設情况下，它通過 stdio 使用模型上下文協議（MCP），並可通過 --http 標志選擇流式 HTTP。它通過探測 8188 然後 8000 端口來自動检測 ComfyUI 端口，並檢查各操作系統上的常见安裝路径。根據環境選擇三種部署模式：本地模式、远程模式（當 COMFYUI_URL 指向非回環主机時）和云模式（當設置了 COMFYUI_API_KEY 時）。README 指出，远程模式會跳過 COMFYUI_PATH 自動检測，以免過時的本地安裝干扰。
專案核對 1：請在 artokun-comfyui-mcp-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
artokun-comfyui-mcp-deep-analysis 第 2 節的具體核對點是 artokun-comfyui-mcp-deep-analysis｜服務器如何發現並與 ComfyUI 通信 · artokun-comfyui-mcp-deep-analysis。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
artokun-comfyui-mcp-deep-analysis｜工具與技能表面 · artokun-comfyui-mcp-deep-analysis
artokun-comfyui-mcp-deep-analysis｜工具與技能表面 · artokun-comfyui-mcp-deep-analysis 的專案脈絡：README 給出了两個工具和技能數量：顶部横幅显示 151 個 MCP 工具和 37 個 AI 技能，而插件部分列出总共 35 個技能。這些工具涵盖图像生成、音頻生成、工作流執行、驗證、組合、模型管理和诊斷。插件添加了斜杠指令，如用於图像生成的 /comfy:gen 和用於诊斷失败的 /comfy:debug，以及编码了针對 Flux、WAN、LTX 2.3、Qwen 等模型家族的特定指導的技能。該項目還附带安裝包，將自定義节点、模型 URL 和工作流捆绑在一起，用於一键設置。
專案核對 2：請在 artokun-comfyui-mcp-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
artokun-comfyui-mcp-deep-analysis 第 3 節的具體核對點是 artokun-comfyui-mcp-deep-analysis｜工具與技能表面 · artokun-comfyui-mcp-deep-analysis。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
artokun-comfyui-mcp-deep-analysis｜面板代理與提供商無關的設計 · artokun-comfyui-mcp-deep-analysis
artokun-comfyui-mcp-deep-analysis｜面板代理與提供商無關的設計 · artokun-comfyui-mcp-deep-analysis 的專案脈絡：除了無頭 MCP 服務器之外，該包還包括一個面板编排器，為 ComfyUI Agent Panel 提供支援，該面板是嵌入 ComfyUI 侧边栏的自主代理。該面板可以在 Claude 或 ChatGPT 订閱、通過 Ollama 的本地模型或任何托管模型上執行。编排器定義了一個提供商中立的 AgentBackend 端口，带有 Claude（通過 Claude Agent SDK）和 Codex（通過 OpenAI codex app-server）的適配器。README 稱面板工具和模型知识在所有提供商中相同，並且能力矩阵讓面板在僅一個後端支援的功能上優雅降級。connect 指令允許用戶本地執行编排器並通過 WebSocket 隧道驱動远程 ComfyUI。
專案核對 3：請在 artokun-comfyui-mcp-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
artokun-comfyui-mcp-deep-analysis 第 4 節的具體核對點是 artokun-comfyui-mcp-deep-analysis｜面板代理與提供商無關的設計 · artokun-comfyui-mcp-deep-analysis。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
artokun-comfyui-mcp-deep-analysis｜設定與環境 · artokun-comfyui-mcp-deep-analysis
artokun-comfyui-mcp-deep-analysis｜設定與環境 · artokun-comfyui-mcp-deep-analysis 的專案脈絡：服務器從環境變量和設定檔案讀取設定。關键變量包括用於指向特定 ComfyUI 的 COMFYUI_URL、用於跳過自動检測的 COMFYUI_PATH、用於 Comfy Cloud 的 COMFYUI_API_KEY，以及用於反向代理後自托管實例的 COMFYUI_AUTH_TOKEN。還有一個社區維護的 model-settings.json，其中包含超過十個模型家族的采樣器、调度器、步數和 CFG 預設；用戶覆盖項放在 model-settings.user.jsonc 中，該檔案從模板自動創建。README 記錄了一個內容尋址存儲的下載缓存和可選的 LRU 上限。
專案核對 4：請在 artokun-comfyui-mcp-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
artokun-comfyui-mcp-deep-analysis 第 5 節的具體核對點是 artokun-comfyui-mcp-deep-analysis｜設定與環境 · artokun-comfyui-mcp-deep-analysis。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
artokun-comfyui-mcp-deep-analysis｜開發與許可 · artokun-comfyui-mcp-deep-analysis
artokun-comfyui-mcp-deep-analysis｜開發與許可 · artokun-comfyui-mcp-deep-analysis 的專案脈絡：開發需要 Node.js 22 或更高版本以及執行中的 ComfyUI。倉庫包含用於構建、測試、程式碼檢查（lint）和查看生成統計信息的腳本。項目結構將 MCP 工具注册分离為 src/tools 下的按組檔案，並提供工作流執行、組合、驗證和模型管理服務。許可證是 MIT，如 LICENSE 檔案所述。MIT 文本授予使用、複製、修改、合並、發布、分發、再許可和銷售副本的權利，並聲明不提供保修；它沒有提及安全保證、支援或生產就绪性。
artokun-comfyui-mcp-deep-analysis｜開發與許可 · artokun-comfyui-mcp-deep-analysis：artokun/comfyui-mcp 的驗收應從執行中的 ComfyUI 開始，先觀察 8188 與 8000 連接埠探測結果，再以 COMFYUI_URL 指向固定實例，檢查 REST API 與 WebSocket 是否都能完成一次工作流。若使用遠端模式，應確認 COMFYUI_PATH 沒有意外覆寫；若使用 Comfy Cloud，則要分開檢查 COMFYUI_API_KEY 的權限與請求去向。model-settings.user.jsonc 是使用者覆寫點，測試 Flux、WAN 或其他模型時應記錄取樣器、步數與 CFG，而不是只保存生成圖。
artokun-comfyui-mcp-deep-analysis｜開發與許可 · artokun-comfyui-mcp-deep-analysis：README 將 MCP 的 stdio 預設與 --http 串流 HTTP 分開。測試時以 COMFYUI_URL 指向固定實例，另測 COMFYUI_PATH、COMFYUI_AUTH_TOKEN 與 COMFYUI_API_KEY，並記錄 model-settings.user.jsonc 的取樣器、步數和 CFG 覆寫。伺服器會探測 8188 再探測 8000，這個順序可用來辨識連錯實例的情況；遠端模式會跳過 COMFYUI_PATH 自動偵測。模型下載快取採內容定址，應觀察同一模型第二次請求是否重用檔案，以及 LRU 上限是否真的限製磁碟用量。面板代理還有 Claude、Codex、Ollama 與託管模型提供者，應逐一核對能力矩陣的降級結果。
專案核對 5：請在 artokun-comfyui-mcp-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。
artokun-comfyui-mcp-deep-analysis 第 6 節的具體核對點是 artokun-comfyui-mcp-deep-analysis｜開發與許可 · artokun-comfyui-mcp-deep-analysis。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
編輯結論
適合已经執行 ComfyUI、希望用自然語言管理工作流的創作者和開發者，不適合把远程連接、模型下載和 Agent 操作直接開放到不受控網絡。先启動本地 ComfyUI，使用預設 8188 端口跑一個可回滚工作流，檢查 REST/WebSocket 日志、模型缓存和 COMFYUI_URL 或 API key 的數據边界。
社群筆記