ComfyUI MCP

Type: Docker / npm
Group: Image
Port: 8000

Description

Connects to ComfyUI for image generation workflows and processing.

Deployment Options

Option 1: Inside MCP Gateway (Docker-in-Docker)

Runs as a Docker container spawned by the MCP Gateway:

Configuration (pre-set):

Image: ghcr.io/richardi-ai/comfyui-mcp-server:latest
Command: --port 8000
Connects to ComfyUI at http://comfyui:8188

Option 2: Local npm (for testing)

# Run locally
npx -y @richardi-ai/comfyui-mcp-server --port 8000

# Or with custom ComfyUI URL
npx -y @richardi-ai/comfyui-mcp-server --port 8000 \
  --base-url http://192.168.1.40:18002

Environment Variables

COMFYUI_URL=http://comfyui:8188
COMFYUI_WS_URL=ws://comfyui:8188

Features

Generate images via ComfyUI workflows
Submit workflow JSON to ComfyUI
Check workflow status
Retrieve generated images
WebSocket support for real-time updates
Integrated with Claude.ai custom connector

ComfyUI Integration

This MCP server connects to the existing ComfyUI instance:

Base URL: http://comfyui:8188 (internal Docker network)
Public URL: http://192.168.1.40:18002

Usage in Claude.ai

Available tools:

comfyui_generate - Generate images with ComfyUI
comfyui_workflow - Submit workflow JSON
comfyui_status - Check workflow status
comfyui_history - Get generation history

Testing

# Test locally (adjust URL if needed)
COMFYUI_URL=http://192.168.1.40:18002 \
npx -y @richardi-ai/comfyui-mcp-server --port 8000

# Verify health
curl http://localhost:8000/health

Documentation: /opt/stacks/ai/mcp-servers/comfyui/
Gateway UI: https://mcp.nuclide.systems/ui (OAuth required)
ComfyUI: http://192.168.1.40:18002

1.8 KiB Raw Blame History