心智模型
ComfyUI MCP 是蓋在正在執行的 ComfyUI 執行個體上面的一層薄、描述清楚的封裝。大多數工具 透過它的 HTTP/WebSocket API 交談，所以無論 ComfyUI 在本機、遠端（--comfyui-url）還是
Comfy Cloud（COMFYUI_API_KEY），行為都一樣。
1
生成與工作流程 → ComfyUI HTTP API
generate_image、enqueue_workflow、佇列 / 歷史 / 系統狀態，以及工作流程編寫工具，
都會呼叫 ComfyUI 的 /prompt、/queue、/history、/object_info 等。排入佇列是
fire-and-forget：你立刻拿到一個 prompt_id，結果透過完成通知到達。雲端模式下，
另一套 cloud-client 把同樣的操作用 X-API-Key 派發到 cloud.comfy.org。2
自訂節點與模型 → ComfyUI-Manager（HTTP），並帶回退到子行程
節點安裝 / 更新 / 快照 / 二分，以及工作流程相依安裝，優先走
ComfyUI-Manager HTTP API
（因此對遠端執行個體也能用），API 做不到的部分再回退到對著本機安裝跑
cm-cli / git /
pip/uv。3
安裝與檔案系統操作 → 僅本機
安裝 ComfyUI、更新核心、刪除模型檔案、讀伺服器記錄、列出輸出目錄，都作用在本機
檔案系統上。它們需要已知的
COMFYUI_PATH，在遠端或雲端模式下會回傳明確錯誤。4
WebSocket → 本機 + 遠端，不含雲端
任務完成通知在可用時掛到 ComfyUI 的 WebSocket。Comfy Cloud 沒有 WebSocket ——
任務監視器會落到已有的 HTTP 輪詢路徑。
經驗法則：任何讀取或執行已連線伺服器的事情，三種模式都能用；任何安裝軟體或
碰磁碟上檔案的事情，都需要本機安裝。完整功能對照表請看
設定 → 部署模式。
自愈：佇列 / 算圖看門狗
以前，一個卡住的高解析度取樣步驟會讓代理在它看不見也殺不掉的殭屍算圖後面繼續堆任務。 三道盡力而為的護欄補上這個缺口，於是代理不會再對著卡住的算圖盲目重排入佇列：- 背壓 —— 已經有算圖在跑時，
panel_run會在結果裡追加一條 QUEUE WARNING， 這樣代理就不會再往後面堆。 - 停滯偵測 —— 一條被動 WebSocket 追蹤正在跑的 prompt / 節點 / 進度；某一步超過
門檻值還沒推進
（
COMFYUI_MCP_STALL_S，預設 180 秒） 時，會在代理下一輪前面預置一行 STALL/BACKLOG 說明。 - 升級取消 ——
queue（action:“cancel”）會中斷、核實任務確實停了 （在COMFYUI_MCP_INTERRUPT_S內，預設 30 秒）， 然後升級到/free，如果它還不肯死就報告算圖 WEDGED（並建議restart_comfyui）；clear_pending在同一次呼叫裡丟掉所有待處理任務。
get_image (action:"analyze_color") 在不走視覺往返的情況下推理一張圖的顏色
（主色板、平均 + 亮度統計、對比度檢查）。
工具分類
圖片生成
工作流程執行
工作流程編寫
工作流程庫
素材與圖片
模型
自訂節點
API 節點
安裝與環境
行程控制
預設值、統計與技能
工具參考由即時 MCP 工具 schema 生成（
npm run docs:gen），所以它不會和程式碼脫節。