Skip to main content
Glama

comfyui-mcp

Servidor del Model Context Protocol (MCP) para ComfyUI. Expone flujos de trabajo locales (o alojados en Comfy Cloud) como una superficie de herramientas para que agentes de chat, diarios y paneles puedan generar imágenes, vídeo, audio y 3D.

Qué hace

  • Ejecutar cualquier flujo de trabajo en formato API con inyección de parámetros

  • Transmitir la salida como un archivo (imagen / vídeo / audio)

  • Gestionar la cola, interrumpir, liberar VRAM

  • Listar nodos personalizados y modelos instalados

  • Subir imágenes para img2img / inpaint

  • Instalar nodos personalizados y modelos mediante comfy-cli

Related MCP server: comfy-mcp

Arquitectura

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

Se incluyen tres transportes:

Transporte

URL

Caso de uso

stdio

n/a

Claude Desktop, Hermes, cualquier cliente MCP-stdio

HTTP REST

http://localhost:9300/...

curl, webhooks, paneles

Streamable HTTP MCP

http://localhost:9300/mcp

Clientes MCP del lado del navegador

Privacidad

Este repositorio es completamente público. No hay secretos en este código. Todas las credenciales del backend se configuran en tiempo de ejecución mediante variables de entorno (consulte .env.example):

  • COMFYUI_HOST — host:puerto del servidor local de ComfyUI

  • COMFY_CLOUD_API_KEY — si se establece, apuntar a platform.comfy.org en su lugar

  • COMFYUI_AUTH_TOKEN — token bearer opcional para servidores autoalojados

El código incluido nunca ve tus claves API.

Herramientas expuestas

Herramienta

Propósito

comfy_health

Ping a /system_stats

comfy_run_workflow

Enviar un JSON de flujo de trabajo con parámetros

comfy_get_output

Obtener la imagen/vídeo resultante por prompt_id

comfy_queue_status

Ver la cola

comfy_interrupt

Cancelar trabajo en ejecución

comfy_free_memory

Descargar modelos

comfy_list_nodes

Listar nodos personalizados instalados

comfy_list_models

Listar checkpoints, loras, vae, etc. instalados

comfy_upload_image

Subir imagen para img2img / inpaint

comfy_install_node

Instalar un nodo personalizado

comfy_install_model

Descargar un modelo

Inicio rápido

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 debe estar ejecutándose en el host:puerto configurado (127.0.0.1:8188 por defecto).

Inicie el puente HTTP para uso con curl/panel:

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

Inicie el transporte Streamable HTTP MCP:

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

Licencia

MIT — bifurque libremente, atribuya a Franzferdinan51 / Duckets.

Related MCP Connectors

Related MCP Servers