/ 目錄 / 演練場 / ComfyUI MCP Server
● 社群 joenorton 🔑 需要你的金鑰

ComfyUI MCP Server

作者 joenorton · joenorton/comfyui-mcp-server

本機 ComfyUI 作為 MCP 工具 — 產生影像、音訊和視訊、運行工作流程以及管理資產,而無需開啟 ComfyUI UI。

comfyui-mcp-server 將本地運行的 ComfyUI(連接埠 8188)橋接到任何 MCP 用戶端。 代理可以產生和重新生成圖像、提交自訂工作流程、輪詢和取消作業、查看生成的資產、切換模型和發布輸出 - 所有這些都透過 MCP 工具進行。 對於您不想手動拖曳節點的迭代創意工作、批量生成和編程管道運行非常有用。

為什麼要用

核心特性

即時演示

實際使用效果

comfyui-mcp-server.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "comfyui-mcp-server",
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "comfyui-mcp-server": {
      "command": {
        "path": "python",
        "args": [
          "server.py"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add comfyui-mcp-server -- python server.py

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: ComfyUI MCP Server

使用文字提示迭代圖像概念

👤 在地使用 ComfyUI 的設計師和藝術家 ⏱ ~20 min intermediate

何時使用: 您已設定 ComfyUI,但希望透過聊天而不是節點圖進行迭代。

前置條件
  • ComfyUI 運作在連接埠 8188 — 依照ComfyUI安裝;確保檢查點模型位於 models/checkpoints/ 中
  • MCP伺服器啟動 — python server.py(監聽http://127.0.0.1:9000/mcp)
步驟
  1. 生成v1
    生成影像:真實肖像、陰光、1024×1280。✓ 已複製
    → 作業已提交;返回的id;完成後出現圖像
  2. 透過調整重新生成
    從那顆種子中重生——稍微溫暖的色調,保持構圖。✓ 已複製
    → 相同的構圖,更溫暖的色彩
  3. 查看+發布
    查看最新圖片;將其作為“portrait-final.png”發佈到圖庫。✓ 已複製
    → 資產元資料+發布URL

結果: 無需點擊節點即可快速迭代。

注意事項
  • 忘記 ComfyUI 必須在 MCP 伺服器啟動之前運行 — 首先啟動 ComfyUI,然後啟動 MCP 伺服器
搭配使用: filesystem

從聊天啟動已儲存的 ComfyUI 工作流程

👤 具有已建立的 ComfyUI 工作流程的團隊 ⏱ ~15 min intermediate

何時使用: 您已經建立了一個工作流程;現在您想以程式設計方式運行它。

前置條件
  • 儲存在 ComfyUI 中的工作流程 — 另存為 → 工作流程 JSON
步驟
  1. 列出工作流程
    列出我的工作流程。✓ 已複製
    → 具有名稱/ID 的數組
  2. 運行它
    執行“product-shot-v3”,正值=“大理石上的陶瓷杯”,負值=“模糊”。✓ 已複製
    → 創造就業機會;參數回顯
  3. 等待+取得結果
    告訴我什麼時候完成並顯示圖像。✓ 已複製
    → 投票隊列;完成後返回資產

結果: 透過聊天進行工作流程編排 - 非常適合批量運行。

注意事項
  • 工作流程引用未安裝的自訂節點 — 運行前在 ComfyUI 中安裝所需的自訂節點
搭配使用: comfy-pilot

透過視訊工作流程將短腳本轉換為視頻

👤 製作短片的內容創作者 ⏱ ~45 min advanced

何時使用: 您有 ComfyUI 視訊工作流程(例如 AnimateDiff / Mochi)並希望按順序提供提示。

步驟
  1. 載入影片工作流程
    使用場景清單執行「shorts-v2」工作流程:[場景提示]。✓ 已複製
    → 分段排隊;每個場景的進度
  2. 縫合並發布
    發布最終影片。✓ 已複製
    → 輸出路徑+發布元數據

結果: 透過本地計算的短視頻,每次渲染無需雲端費用。

注意事項
  • 較長剪輯上的 GPU 記憶體耗盡 — 降低解析度或每段幀數;依序批次處理

組合

與其他 MCP 搭配,撬動十倍槓桿

comfyui-mcp-server + comfy-pilot

將此 MCP 與 Claude-Code-in-ComfyUI 編輯器配對以進行全流程創作

透過 comfy-pilot 建立工作流程,並透過此 MCP 伺服器運行它。✓ 已複製
comfyui-mcp-server + filesystem

在專案資料夾下組織產生的資源

每批處理後,將輸出移至 ./assets/<project>/ 並帶有日期的檔案名稱。✓ 已複製
comfyui-mcp-server + mcp-image

將 mcp-image 用於一次性 Gemini 世代;適用於您本地 SD/FLUX 管道的 ComfyUI

Draft hero via mcp-image; deliver brand set via the ComfyUI workflow.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
generate_image prompt, settings 標準文字到圖像 local compute only
generate_song / generate_video prompt, workflow 透過專用工作流程產生音訊/視頻 local compute
regenerate reference job_id, tweaks 迭代先前的結果 local compute
view_image asset_id 顯示內聯資產 0
get_queue_status / get_job / cancel_job job_id 生命週期管理 0
list_assets / get_asset_metadata filter 瀏覽產生的輸出 0
list_models / get_defaults / set_defaults optional model name 切換檢查點或調整預設值 0
list_workflows / run_workflow name + inputs 運行已儲存的工作流程 0 to start
publish_asset / get_publish_info asset_id 標記最終資產 0

成本與限制

運行它的成本

API 配額
僅限本地 — 受您的 GPU 約束
每次呼叫 Token 數
提示文字小;資產字節大
費用
免費—您的電力和硬體
提示
使用較低的步長/較小的分辨率進行迭代;為守門員保留完整設定。

安全

權限、密鑰、影響範圍

憑證儲存: 沒有本地 ComfyUI 的憑證。 如果您將其代理到雲端,請在代理處新增身份驗證。
資料出站: ComfyUI 在本地運行;伺服器流量預設為127.0.0.1。 根據您的工作流程,從 HuggingFace / CivitAI 取得模型下載。

故障排查

常見錯誤與修復

連線被拒絕 127.0.0.1:8188

先啟動ComfyUI;確認 UI 在瀏覽器中載入。

驗證: curl localhost:8188/system_stats
工作流程因缺少自訂節點而失敗

開啟 ComfyUI Manager 並安裝所需的自訂節點,然後重試。

驗證: Manager → Install Missing Custom Nodes
作業排隊但從未完成

檢查 ComfyUI 自己的控制台是否有 CUDA OOM 或模型載入錯誤。

驗證: Inspect the ComfyUI terminal output

替代方案

ComfyUI MCP Server 對比其他方案

替代方案何時用它替代權衡
comfy-pilot您需要一個編輯器,讓 Claude 在 ComfyUI 內部起草工作流程不是純粹的MCP伺服器;需要安裝 ComfyUI 節點
mcp-image您希望透過 Gemini 進行零設定雲生成按圖片付費;工作流程彈性較低
everart您需要經過風格訓練的雲模型不同的提供者

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills