ComfyUI MCP Server MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Geração: imagens, áudio, vídeo via ComfyUI local
Fluxos de trabalho: liste e execute fluxos de trabalho ComfyUI salvos
Ciclo de vida do trabalho: status da fila, obtenção/cancelamento de trabalho
Ativos: listar, visualizar, obter metadados, publicar
Configuração: listar modelos, obter/definir padrões

Demo ao vivo

Como fica na prática

comfyui-mcp-server.replay ▶ pronto

0/0

Instalar

Escolha seu 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"
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a 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"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "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"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "comfyui-mcp-server",
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "comfyui-mcp-server": {
      "command": {
        "path": "python",
        "args": [
          "server.py"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: ComfyUI MCP Server

Iterar um conceito de imagem com prompts de texto

👤 Designers e artistas usando ComfyUI localmente ⏱ ~20 min intermediate

Quando usar: Você configurou o ComfyUI, mas deseja iterar via chat em vez de gráficos de nós.

Pré-requisitos

ComfyUI rodando na porta 8188 — Siga a instalação do ComfyUI; garantir que um modelo de ponto de verificação esteja em modelos/pontos de verificação/
Servidor MCP iniciado — python server.py (ouve em http://127.0.0.1:9000/mcp)

Fluxo

Gerar v1

Gere uma imagem: retrato fotorreal, luz nublada, 1024×1280.✓ Copiado

→ Trabalho enviado; id retornado; a imagem aparece quando terminar
Regenerar com ajustes

Regenere a partir dessa semente – tons um pouco mais quentes, mantenha a composição.✓ Copiado

→ Mesma composição, cores mais quentes
Ver + publicar

Veja a imagem mais recente; publique-o na galeria como 'portrait-final.png'.✓ Copiado

→ Metadados de ativos + URL de publicação

Resultado: Iteração rápida sem clicar nos nós.

Armadilhas

Esquecer que o ComfyUI deve estar em execução antes do servidor MCP iniciar — Inicie o ComfyUI primeiro e depois o servidor MCP

Combine com: filesystem

Inicie um fluxo de trabalho ComfyUI salvo no chat

👤 Equipes com fluxos de trabalho ComfyUI estabelecidos ⏱ ~15 min intermediate

Quando usar: Você já construiu um fluxo de trabalho; agora você deseja executá-lo programaticamente.

Pré-requisitos

Um fluxo de trabalho salvo no ComfyUI — Salvar como → fluxo de trabalho JSON

Fluxo

Listar fluxos de trabalho

Liste meus fluxos de trabalho.✓ Copiado

→ Matriz com nomes/ids
Execute-o

Execute 'product-shot-v3' com positivo = 'caneca de cerâmica em mármore', negativo = 'embaçado'.✓ Copiado

→ Emprego criado; parâmetros ecoados
Espere + pegue o resultado

Diga-me quando terminar e mostre a imagem.✓ Copiado

→ Fila de pesquisas; retorna o ativo quando concluído

Resultado: Orquestração de fluxo de trabalho por chat — ideal para execuções em lote.

Armadilhas

O fluxo de trabalho faz referência a nós personalizados não instalados — Instale os nós personalizados necessários no ComfyUI antes de executar

Combine com: comfy-pilot

Transforme um pequeno roteiro em um vídeo com um fluxo de trabalho de vídeo

👤 Criadores de conteúdo produzindo curtas ⏱ ~45 min advanced

Quando usar: Você tem um fluxo de trabalho de vídeo ComfyUI (por exemplo, AnimateDiff/Mochi) e deseja alimentar prompts sequencialmente.

Fluxo

Carregar o fluxo de trabalho de vídeo

Execute o fluxo de trabalho 'shorts-v2' com uma lista de cenas: [scene prompts].✓ Copiado

→ Segmentos enfileirados; progresso por cena
Costure e publique

Publique o vídeo final.✓ Copiado

→ Caminho de saída + metadados de publicação

Resultado: Vídeos curtos via computação local, sem taxas de nuvem por renderização.

Armadilhas

Esgotamento da memória da GPU em clipes mais longos — Reduza a resolução ou frames por segmento; lote sequencialmente

Combinações

Combine com outros MCPs para 10× de alavancagem

comfyui-mcp-server + comfy-pilot

Combine este MCP com o editor Claude-Code-in-ComfyUI para criação de pipeline completo

Crie o fluxo de trabalho por meio do comfy-pilot e execute-o por meio deste servidor MCP.✓ Copiado

comfyui-mcp-server + filesystem

Organize os ativos gerados nas pastas do projeto

Após cada lote, mova as saídas para ./assets/<project>/ com nomes de arquivos datados.✓ Copiado

comfyui-mcp-server + mcp-image

Use imagem mcp para gens únicas de Gêmeos; ComfyUI para seus pipelines SD/FLUX locais

Rascunho do herói via imagem mcp; entregar conjunto de marca por meio do fluxo de trabalho ComfyUI.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
generate_image	prompt, settings	Texto para imagem padrão	local compute only
generate_song / generate_video	prompt, workflow	Geração de áudio/vídeo por meio de fluxos de trabalho dedicados	local compute
regenerate	reference job_id, tweaks	Iterar um resultado anterior	local compute
view_image	asset_id	Mostrar um recurso in-line	0
get_queue_status / get_job / cancel_job	job_id	Gerenciamento do ciclo de vida	0
list_assets / get_asset_metadata	filter	Procure resultados gerados	0
list_models / get_defaults / set_defaults	optional model name	Alterne pontos de verificação ou ajuste padrões	0
list_workflows / run_workflow	name + inputs	Execute fluxos de trabalho salvos	0 to start
publish_asset / get_publish_info	asset_id	Marcar um ativo final	0

Custo e limites

O que custa rodar

Cota de API: Somente local – vinculado à sua GPU
Tokens por chamada: Texto de prompt pequeno; bytes de ativos grandes
Monetário: Gratuito – sua eletricidade e hardware
Dica: Use etapas mais baixas/resolução menor para iteração; reserve configurações completas para o goleiro.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhuma credencial para ComfyUI local. Se você fizer proxy para a nuvem, adicione autenticação no proxy.

Saída de dados: ComfyUI é executado localmente; o tráfego do servidor é 127.0.0.1 por padrão. Os downloads de modelos são obtidos do HuggingFace / CivitAI dependendo do seu fluxo de trabalho.

run_workflow executa todos os nós que o fluxo de trabalho contém – incluindo nós personalizados. Revise fluxos de trabalho desconhecidos antes de executá-los.
A publicação pode gravar em locais especificados por um fluxo de trabalho; certifique-se de que os caminhos de publicação permaneçam dentro do seu diretório de ativos.

Solução de problemas

Erros comuns e correções

Conexão recusada 127.0.0.1:8188

Inicie o ComfyUI primeiro; confirme o carregamento da IU em um navegador.

Verificar: curl localhost:8188/system_stats

O fluxo de trabalho falha com nó personalizado ausente

Abra o ComfyUI Manager e instale os nós personalizados necessários e tente novamente.

Verificar: Manager → Install Missing Custom Nodes

Fila de trabalhos, mas nunca concluída

Verifique o próprio console do ComfyUI para ver se há um CUDA OOM ou erro de carregamento de modelo.

Verificar: Inspect the ComfyUI terminal output

Alternativas

ComfyUI MCP Server vs. outros

Alternativa	Quando usar	Troca
comfy-pilot	Você quer um editor que permita que Claude elabore fluxos de trabalho dentro do próprio ComfyUI	Não é um servidor MCP puro; requer instalação do nó ComfyUI
mcp-image	Você deseja geração de nuvem sem configuração via Gemini	Pague por imagem; menos flexibilidade de fluxo de trabalho
everart	Você quer modelos de nuvem treinados em estilo	Fornecedor diferente

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills