comfyui-mcp

Model Context Protocol (MCP)-Server für ComfyUI. Stellt lokale (oder gehostete Comfy Cloud) Workflows als Werkzeugoberfläche bereit, sodass Chat-Agenten, Tagebücher und Dashboards Bilder, Videos, Audio und 3D generieren können.

Was es tut

• Jeden Workflow im API-Format mit Parameterinjektion ausführen

• Die Ausgabe als Datei streamen (Bild / Video / Audio)

• Warteschlange verwalten, unterbrechen, VRAM freigeben

• Installierte benutzerdefinierte Knoten und Modelle auflisten

• Bilder für img2img / Inpaint hochladen

• Benutzerdefinierte Knoten und Modelle über comfy-cli installieren

Related MCP server: Agent Construct

Architektur

┌─────────────────────────┐    stdio / Streamable HTTP / REST    ┌──────────────────┐
│  Chat agent / dashboard │  ────────────────────────────────▶  │  comfyui-mcp     │
│  (Hermes, Claude, etc.) │  ◀────────────────────────────────  │  (Python)        │
└─────────────────────────┘                                     └──────────────────┘
                                                                            │
                                                                            ▼
                                                                  ┌──────────────────┐
                                                                  │  ComfyUI server  │
                                                                  │  127.0.0.1:8188  │
                                                                  │  (or Cloud)      │
                                                                  └──────────────────┘

Drei Transporte werden ausgeliefert:

Datenschutz

Dieses Repository ist vollständig öffentlich. In dieser Codebasis befinden sich keine Geheimnisse. Alle Backend-Anmeldeinformationen werden zur Laufzeit über Umgebungsvariablen konfiguriert (siehe .env.example):

• COMFYUI_HOST — Host:Port des lokalen ComfyUI-Servers

• COMFY_CLOUD_API_KEY — falls gesetzt, stattdessen platform.comfy.org ansteuern

• COMFYUI_AUTH_TOKEN — optionales Bearer-Token für selbst gehostete Server

Der ausgelieferte Code sieht niemals Ihre API-Schlüssel.

Verfügbare Werkzeuge

Schnellstart

git clone https://github.com/Franzferdinan51/comfyui-mcp
cd comfyui-mcp
cp .env.example .env
# edit .env to point at your ComfyUI server
pip install -r requirements.txt
./scripts/comfyui-mcp.bat     # or python scripts/comfyui_mcp_server.py

ComfyUI muss auf dem konfigurierten Host:Port laufen (standardmäßig 127.0.0.1:8188).

Starten Sie die HTTP-Bridge für die Verwendung mit curl/Dashboard:

python scripts/comfyui_http_bridge.py
# → http://localhost:9300

Starten Sie den Streamable HTTP MCP-Transport:

python scripts/comfyui_streamable_http.py
# → http://localhost:9300/mcp

Lizenz

MIT — frei forken, mit Namensnennung an Franzferdinan51 / Duckets.