Skip to content
MCP server

ComfyUI MCP

Self-hosted MCP bridge that lets agents generate images and video on your ComfyUI GPU

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, Linux, API
Runs
Locally
Version
0.1.1
Listing updated
today

Similar MCP servers

About ComfyUI MCP

ComfyUI MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

This is only the MCP and transport layer. The ComfyUI engine and model weights are not included, so you run ComfyUI yourself and point COMFYUI_URL at it. The server then builds the workflow JSON and serves it to clients on your network over HTTP/SSE (default port 8201), so client machines need no PyTorch or local SDXL models.

A built-in GPU arbiter switches a 12 GB card between llama-server and ComfyUI to avoid VRAM collisions. Image generation offers presets such as producto (RealVisXL V4.0), realista (Juggernaut XL), rapido and anime, with aspect ratios, seeds, batches of up to four, optional LoRA and a face-detail pass.

Video uses Wan 2.2 and needs separate models. The README reports local benchmarks of roughly 27-32 minutes for a 5-second 5B clip and about 8 minutes for an A14B image-to-video clip, and says the MCP video integration has not yet been tested against the real GPU. It also warns that without MCP_AUTH_TOKEN anyone on the LAN can use the GPU.

Install

Run in a terminal

claude mcp add comfyui-mcp --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- docker run -i --rm -e MCP_AUTH_TOKEN ghcr.io/germaniu/comfyui-mcp:0.1.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/germaniu/comfyui-mcp:0.1.1"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/germaniu/comfyui-mcp:0.1.1"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "comfyui-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/germaniu/comfyui-mcp:0.1.1"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/germaniu/comfyui-mcp:0.1.1"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "comfyui-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/germaniu/comfyui-mcp:0.1.1"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • COMFYUI_URLLoopback URL of the ComfyUI engine. Inside a container 127.0.0.1 is the container itself, so point it at the host running ComfyUI (e.g. http://host.docker.internal:8188 or the LAN IP).
  • COMFYUI_PUBLIC_URLLAN base URL used to build direct image download links.
  • MCP_AUTH_TOKENOnly applies when the container runs in HTTP mode. If set, every HTTP request must carry an Authorization: Bearer header.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

generate_image
Text-to-image with SDXL presets, aspect ratios and optional LoRA.
img2img
Vary an existing generated image with a denoise level.
generate_video
Make a 1-5 second MP4 with Wan 2.2.

What it does

Text to image
generate_image runs SDXL with presets, aspect ratios, seeds and batches of 1-4.
Image variations
img2img varies a generated image with an adjustable denoise level.
Short video
generate_video makes 1-5 second MP4 clips with Wan 2.2.
GPU arbiter
Alternates a 12 GB GPU between llama-server and ComfyUI without VRAM clashes.
Optional bearer auth
MCP_AUTH_TOKEN makes every HTTP request carry an Authorization header.
Preview thumbnails
Can return a small JPEG so vision-capable models see the result.

Good for

  • Give Claude Code or Cursor an image generator on your own GPU
  • Produce product-style images for an agent workflow
  • Create variations of an earlier render
  • Share one GPU between a local LLM and image generation

Pricing

Open source

Open source; you supply your own GPU, ComfyUI and models

ComfyUI MCP FAQ

Does it include ComfyUI?

No. You need a separate ComfyUI backend and model files; this project only provides the MCP interface.

What does it need to run?

Python 3.11+ and uv or pip; the registry also lists an OCI image.

Is it secure on a LAN?

Only if you set MCP_AUTH_TOKEN. Without it, any LAN host can generate images and occupy the GPU.

Is video generation proven?

The README says the MCP integration has not been tested against the real GPU yet, though it gives local benchmark timings.

Is ComfyUI MCP free?

Yes. ComfyUI MCP is open source, so you can use and self-host it for free.

How do I add ComfyUI MCP to Claude Code?

Run this command in your terminal: claude mcp add comfyui-mcp --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- docker run -i --rm -e MCP_AUTH_TOKEN ghcr.io/germaniu/comfyui-mcp:0.1.1

What are the best alternatives to ComfyUI MCP?

The closest alternatives to ComfyUI MCP are HyperFrames by HeyGen, headroom, omniget, next-ai-draw-io and mcp-for-blender.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers