n8n-mcp

Visão Geral

n8n-mcp é um servidor open-source Model Context Protocol (MCP) que conecta assistentes de codificação com IA à plataforma de automação de workflows n8n. Ele equipa ferramentas como Claude Desktop, Claude Code, Cursor, Windsurf e VS Code com conhecimento estruturado e em tempo real de todo o ecossistema n8n — incluindo 537 nodes principais + 547 nodes da comunidade (total de 1.084), 2.709 templates de workflows e lógica de validação específica para IA.

Construído como uma aplicação leve em Node.js com banco de dados SQLite embutido, oferece respostas em menos de 12 ms e funciona nos modos stdio ou HTTP. Conecte uma única vez e deixe sua IA construir, validar, testar e implantar workflows completos do n8n sem copiar-colar ou configuração manual.

Uma versão hospedada com Chat Agent pronto para uso está disponível em n8n-mcp.com (plano gratuito + planos pagos), enquanto o repositório no GitHub permanece totalmente auto-hospedável sob a licença MIT.

Principais Recursos

• Base de Conhecimento Completa de Nodes — Acesso total a 1.084 nodes do n8n com 99% de cobertura de propriedades, 63,6% de cobertura de operações e 87% da documentação oficial (atualizada em até 48 horas após novos releases do n8n).
• Busca Inteligente e Descoberta — search_nodes, get_node (vários modos de detalhe) e filtragem de nodes da comunidade por origem (verificados/comunidade).
• Exemplos do Mundo Real — 2.646 configurações extraídas previamente de templates populares.
• Validação Avançada — validate_node e validate_workflow com perfis de agentes IA, verificações em tempo de execução e análise de dependências. Suporta workflows AI Agent do n8n v2.17+.
• Engine de Templates — Busca e recuperação de mais de 2.709 JSONs de workflows prontos para uso com filtragem inteligente.
• Ferramentas de Gerenciamento n8n (conexão API opcional) — Criar, atualizar, testar, executar e corrigir automaticamente workflows diretamente na sua instância n8n.
• Desempenho e Compatibilidade — ~12 ms de resposta média, consumo de memória de 70–120 MB, compatível com qualquer versão do Node.js. Suporta modos stdio (Claude Desktop) e HTTP/SSE.
• Privacidade e Segurança — Telemetria anônima opcional (fácil de desativar), sem credenciais hard-coded, modos de segurança para webhooks.

Instalação e Configuração

Início Rápido (npx – sem instalação)

npx n8n-mcp

Adicione ao seu claude_desktop_config.json do Claude Desktop com MCP_MODE=stdio.

Docker (recomendado para produção)

docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest

Nuvem (one-click)

Implante gratuitamente no Railway usando o template do repositório.

Build Local Completo

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start

Variáveis de ambiente opcionais: N8N_API_URL, N8N_API_KEY (para gerenciamento direto de workflows), LOG_LEVEL=error, MCP_MODE=stdio.

Assistentes de IA Suportados

• Claude Desktop / Claude Code
• Cursor
• Windsurf
• VS Code + Codex
• Antigravity
• Qualquer cliente compatível com MCP (mais de 20 ferramentas via serviço hospedado)

Casos de Uso

• Criação de Workflows Impulsionada por IA — Descreva “monitorar menções no Twitter e postar resumos no Slack com análise de sentimento” → a IA gera, valida e implanta o JSON completo.
• Manutenção de Workflows Existentes — A IA lê workflows ao vivo, sugere otimizações e aplica atualizações direcionadas.
• Exploração de Templates — Peça “o melhor template de sincronização com CRM usando nodes da comunidade” e receba JSON pronto para importar.
• Automação Empresarial — Conecte a instâncias n8n auto-hospedadas para geração segura e auditável de workflows em escala.
• Aprendizado e Prototipagem — Use ferramentas de validação para ensinar as melhores práticas à IA antes do deploy em produção.

MCP Nativo do n8n vs n8n-mcp

O servidor MCP nativo do n8n (disponível em releases recentes) expõe seus próprios workflows como ferramentas. O n8n-mcp é um servidor MCP externo complementar focado no conhecimento dos nodes do n8n e na criação assistida por IA. Use os dois juntos para potência máxima: servidor nativo para disparar workflows + n8n-mcp para construção inteligente de workflows.

Links e Recursos

• GitHub: czlonkowski/n8n-mcp
• Chat Agent Hospedado & Dashboard: n8n-mcp.com
• Plano gratuito: 100 chamadas de ferramentas/dia (hospedado) ou ilimitado no auto-hospedagem
• Documentação e exemplos no repositório

n8n-mcp transforma qualquer assistente de codificação com IA em um especialista completo em workflows n8n — instantaneamente.