/ Directorio / Playground / ComfyUI MCP Server
● Comunidad joenorton 🔑 Requiere tu clave

ComfyUI MCP Server

por joenorton · joenorton/comfyui-mcp-server

ComfyUI local como herramienta MCP: genere imágenes, audio y video, ejecute flujos de trabajo y administre activos sin abrir la interfaz de usuario de ComfyUI.

ComfyUI-mcp-server conecta un ComfyUI que se ejecuta localmente (puerto 8188) con cualquier cliente MCP. Los agentes pueden generar y regenerar imágenes, enviar flujos de trabajo personalizados, sondear y cancelar trabajos, ver activos generados, cambiar modelos y publicar resultados, todo a través de herramientas MCP. Útil para trabajos creativos iterativos, generación por lotes y ejecuciones de canalizaciones programáticas en las que no desea arrastrar nodos manualmente.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

comfyui-mcp-server.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "comfyui-mcp-server",
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "comfyui-mcp-server": {
      "command": {
        "path": "python",
        "args": [
          "server.py"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add comfyui-mcp-server -- python server.py

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: ComfyUI MCP Server

Iterar un concepto de imagen con indicaciones de texto

👤 Diseñadores y artistas que utilizan ComfyUI localmente ⏱ ~20 min intermediate

Cuándo usarlo: Tiene ComfyUI configurado pero desea iterar a través del chat en lugar de gráficos de nodos.

Requisitos previos
  • ComfyUI ejecutándose en el puerto 8188 — Siga la instalación de ComfyUI; asegúrese de que un modelo de punto de control esté en modelos/puntos de control/
  • Se inició el servidor MCP — python server.py (escucha en http://127.0.0.1:9000/mcp)
Flujo
  1. Generar v1
    Generar una imagen: retrato fotorrealista, luz nublada, 1024×1280.✓ Copiado
    → Trabajo enviado; identificación devuelta; la imagen aparece cuando termina
  2. Regenerar con ajustes
    Regenera a partir de esa semilla: tonos ligeramente más cálidos, mantén la composición.✓ Copiado
    → Misma composición, colores más cálidos.
  3. Ver + publicar
    Ver la imagen más reciente; publíquelo en la galería como 'portrait-final.png'.✓ Copiado
    → Metadatos de activos + URL de publicación

Resultado: Iteración rápida sin hacer clic en los nodos.

Errores comunes
  • Olvidar que ComfyUI debe estar ejecutándose antes de que se inicie el servidor MCP — Inicie ComfyUI primero, luego el servidor MCP
Combinar con: filesystem

Inicie un flujo de trabajo de ComfyUI guardado desde el chat

👤 Equipos con flujos de trabajo ComfyUI establecidos ⏱ ~15 min intermediate

Cuándo usarlo: Ya has creado un flujo de trabajo; ahora desea ejecutarlo mediante programación.

Requisitos previos
  • Un flujo de trabajo guardado en ComfyUI — Guardar como → flujo de trabajo JSON
Flujo
  1. Listar flujos de trabajo
    Enumera mis flujos de trabajo.✓ Copiado
    → Matriz con nombres/identificadores
  2. ejecutarlo
    Ejecute 'product-shot-v3' con positivo='taza de cerámica sobre mármol', negativo='borroso'.✓ Copiado
    → Empleo creado; parámetros repetidos
  3. Espera + toma el resultado
    Dime cuando termine y muestra la imagen.✓ Copiado
    → Cola de urnas; devuelve el activo cuando está completo

Resultado: Orquestación del flujo de trabajo desde el chat: ideal para ejecuciones por lotes.

Errores comunes
  • El flujo de trabajo hace referencia a nodos personalizados no instalados — Instale los nodos personalizados necesarios en ComfyUI antes de ejecutar
Combinar con: comfy-pilot

Convierta un guión corto en un vídeo con un flujo de trabajo de vídeo

👤 Creadoras de contenido produciendo cortos ⏱ ~45 min advanced

Cuándo usarlo: Tiene un flujo de trabajo de vídeo ComfyUI (por ejemplo, AnimateDiff/Mochi) y desea enviar indicaciones de forma secuencial.

Flujo
  1. Cargar el flujo de trabajo del vídeo
    Ejecute el flujo de trabajo 'shorts-v2' con una lista de escenas: [indicaciones de escena].✓ Copiado
    → Segmentos en cola; progreso por escena
  2. Coser y publicar
    Publicar el vídeo final.✓ Copiado
    → Ruta de salida + publicar metadatos

Resultado: Vídeos cortos a través de computación local, sin tarifas de nube por renderizado.

Errores comunes
  • Agotamiento de la memoria de la GPU en clips más largos — Reducir la resolución o fotogramas por segmento; lote secuencialmente

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

comfyui-mcp-server + comfy-pilot

Empareje este MCP con el editor Claude-Code-in-ComfyUI para una creación completa

Cree el flujo de trabajo a través de un piloto cómodo y ejecútelo a través de este servidor MCP.✓ Copiado
comfyui-mcp-server + filesystem

Organizar los activos generados en carpetas de proyectos

Después de cada lote, mueva los resultados a ./assets/<proyecto>/ con nombres de archivos fechados.✓ Copiado
comfyui-mcp-server + mcp-image

Utilice mcp-image para generaciones Gemini únicas; ComfyUI para sus canalizaciones SD/FLUX locales

Borrador de héroe a través de mcp-image; entregue el conjunto de marcas a través del flujo de trabajo de ComfyUI.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
generate_image prompt, settings Texto a imagen estándar local compute only
generate_song / generate_video prompt, workflow Generación de audio/vídeo a través de flujos de trabajo dedicados local compute
regenerate reference job_id, tweaks Iterar sobre un resultado anterior local compute
view_image asset_id Mostrar un activo en línea 0
get_queue_status / get_job / cancel_job job_id Gestión del ciclo de vida 0
list_assets / get_asset_metadata filter Explorar resultados generados 0
list_models / get_defaults / set_defaults optional model name Cambiar puntos de control o ajustar los valores predeterminados 0
list_workflows / run_workflow name + inputs Ejecutar flujos de trabajo guardados 0 to start
publish_asset / get_publish_info asset_id Marcar un activo final 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Solo local - limitada por su GPU
Tokens por llamada
Texto rápido pequeño; bytes de activos grandes
Monetario
Gratis: tu electricidad y hardware
Consejo
Utilice pasos más bajos/resolución más pequeña para la iteración; reserve la configuración completa para el guardián.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: No hay credenciales para ComfyUI local. Si lo envía a la nube, agregue autenticación en el proxy.
Salida de datos: ComfyUI se ejecuta localmente; El tráfico del servidor es 127.0.0.1 de forma predeterminada. Las descargas de modelos se obtienen de HuggingFace / CivitAI según su flujo de trabajo.

Resolución de problemas

Errores comunes y soluciones

Conexión rechazada 127.0.0.1:8188

Inicie ComfyUI primero; Confirme que la interfaz de usuario se carga en un navegador.

Verificar: curl localhost:8188/system_stats
El flujo de trabajo falla porque falta un nodo personalizado

Abra ComfyUI Manager e instale los nodos personalizados necesarios, luego vuelva a intentarlo.

Verificar: Manager → Install Missing Custom Nodes
Cola de trabajos pero nunca completa

Verifique la propia consola de ComfyUI para ver si hay un CUDA OOM o un error de carga del modelo.

Verificar: Inspect the ComfyUI terminal output

Alternativas

ComfyUI MCP Server vs otros

AlternativaCuándo usarlaContrapartida
comfy-pilotQuieres un editor que le permita a Claude redactar flujos de trabajo dentro de ComfyUINo es un servidor MCP puro; requiere la instalación del nodo ComfyUI
mcp-imageQuiere una generación de nube sin configuración a través de GeminiPago por imagen; Menos flexibilidad en el flujo de trabajo.
everartQuieres modelos de nube entrenados con estiloProveedor diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills