Docker と Compose - ComfyUI MCP

comfyui-mcp は stdio — compose のサービスにはできない

comfyui-mcp は stdio の MCP サーバー です。ポートはなく、ネットワーク上に何も公開しません: MCP クライアント（Claude Code、Cursor、MCP ブリッジなど）が 子プロセスとして起動し、 stdin/stdout で話します。そのため docker-compose.yml に comfyui-mcp サービスを置いても行き止まりです — 起動し、話す相手がなく、終了します。ComfyUI を compose に組み込むほぼ全員がこれに引っかかります。正しい compose ファイルはサービスが「足りない」ように見えるからです。足りていません: compose するのは ComfyUI で、MCP サーバーは MCP クライアントが動く場所で動き、COMFYUI_URL 経由の素の HTTP で ComfyUI に届きます。

サーバーを起動する npx コマンドには、それを動かすマシン（またはコンテナ）に Node.js >= 22 が必要です — スリムなベースイメージでの最大の落とし穴です。

2 つのデプロイ形態

ローカルの npx + ローカルの ComfyUI

既定です。ComfyUI はマシン上で直接動き、MCP クライアントが npx -y comfyui-mcp@latest を起動し、ローカルインストールとそのポートを自動検出します。設定は不要です。インストールを参照してください。

ローカルの npx + Docker 化 / リモートの ComfyUI

ComfyUI はコンテナ（または別ホスト）で動き、MCP クライアントは今までどおりローカルで comfyui-mcp を起動し、COMFYUI_URL（または --comfyui-url）でそこに向けます。ループバック以外の URL はサーバーを リモートモード にします: すべての HTTP ツールが動きます — カスタムノードのインストールも含み、これは ComfyUI-Manager の HTTP API 経由です。ファイルシステムやローカルプロセスが必要なツール（ComfyUI 自体のインストール、comfy-cli の操作、ログの読み取り、モデルファイルの削除）は明確なエラーを返します。

例: docker-compose の ComfyUI

すぐ使える例がリポジトリの docker/compose/ にあります — ComfyUI をサービスとして（既定は NVIDIA、AMD/ROCm 版はコメントアウト）、モデルと出力のバインドマウント、ヘッダーコメントにクライアント設定:

services:
  comfyui:
    image: yanwk/comfyui-boot:cu130-slim-v2   # community image; :rocm for AMD
    ports:
      - "8188:8188"
    volumes:
      - ./storage/models:/root/ComfyUI/models
      - ./storage/custom_nodes:/root/ComfyUI/custom_nodes
      - ./storage/input:/root/ComfyUI/input
      - ./storage/output:/root/ComfyUI/output
      - ./storage/user:/root/ComfyUI/user
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

それから MCP クライアントをコンテナに向けます。ホスト 上（よくあるケース — 同じマシンの Claude Code）では、公開したポートを使います:

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp@latest"],
      "env": {
        "COMFYUI_URL": "http://localhost:8188"
      }
    }
  }
}

MCP クライアントが同じネットワーク上の 別の compose サービス内 で動く場合（例: Open WebUI の手前にある MCP-to-HTTP ブリッジ）は、localhost ではなく compose のサービス名 を使います:

COMFYUI_URL=http://comfyui:8188

この構成ではブリッジサービスが comfyui-mcp を起動するので、そのイメージには Node.js >= 22 と npx -y comfyui-mcp@latest で起動できるサーバーが必要です。ブリッジはサードパーティのソフトウェアです — それぞれのドキュメントに従って設定してください。例の compose ファイルにはコメントアウトされたスケッチがあります。

AMD / ROCm の注意点

yanwk/comfyui-boot:rocm のイメージタグを使い、例の ROCm パススルーのコメントを外してください — 見逃しやすいのは次です: devices: [/dev/kfd, /dev/dri]、group_add: [video]、 security_opt: [seccomp:unconfined]。
comfyui-mcp 自体に GPU/CUDA 依存はありません — ROCm ホストは完全にサポートされています。エージェントパネルは ComfyUI の拡張機能 でありサービスではなく、外部フロントエンドが操作面なら任意です。
このリポジトリの docker/runpod/ は CUDA 向けの RunPod クラウドイメージ です（クラウドデプロイを参照）。汎用の ComfyUI イメージではないので、AMD ユーザーはそこから始めないでください。

​comfyui-mcp は stdio — compose のサービスにはできない

​2 つのデプロイ形態

ローカルの npx + ローカルの ComfyUI

ローカルの npx + Docker 化 / リモートの ComfyUI

​例: docker-compose の ComfyUI

​AMD / ROCm の注意点

comfyui-mcp は stdio — compose のサービスにはできない

2 つのデプロイ形態

例: docker-compose の ComfyUI

AMD / ROCm の注意点