ComfyUI MCP

Minimal MCP server that wraps ComfyUI HTTP routes so an LLM client can:

• inspect server status, models, features, node metadata

• submit workflows via /prompt

• inspect or manage queue/history

• interrupt runs

• upload input images

Python requirement: 3.10+ (the official mcp SDK requires it).

This server targets ComfyUI local server routes documented in:

• https://docs.comfy.org/development/comfyui-server/comms_routes

• https://docs.comfy.org/development/comfyui-server/api-key-integration

1) Install

cd /Users/apple/projects/comfyui-mcp
python3.10 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e .

Related MCP server: ComfyUI MCP

2) Configure

export COMFYUI_BASE_URL="http://127.0.0.1:8188"
export COMFYUI_ROUTE_PREFIX=""
export COMFYUI_TIMEOUT_SECONDS="60"
# optional: for reverse proxies or cloud-style gateways
export COMFYUI_BEARER_TOKEN=""

Notes:

• COMFYUI_ROUTE_PREFIX can be set to /api if your endpoint is exposed only under /api/*.

• ComfyUI native server supports both prefixed and non-prefixed routes.

• For paid API nodes in workflow payloads, pass api_key_comfy_org in comfyui_submit_prompt.

3) Run (stdio transport)

cd /Users/apple/projects/comfyui-mcp
source .venv/bin/activate
comfyui-mcp

4) Example MCP client config

{
  "mcpServers": {
    "comfyui": {
      "command": "/Users/apple/projects/comfyui-mcp/.venv/bin/comfyui-mcp",
      "env": {
        "COMFYUI_BASE_URL": "http://127.0.0.1:8188",
        "COMFYUI_ROUTE_PREFIX": ""
      }
    }
  }
}

Exposed tools

• comfyui_get_system_stats

• comfyui_get_features

• comfyui_list_models

• comfyui_get_object_info

• comfyui_get_queue

• comfyui_manage_queue

• comfyui_get_history

• comfyui_manage_history

• comfyui_submit_prompt

• comfyui_interrupt

• comfyui_upload_image