n8n-mcp

Resumen

n8n-mcp es un servidor open-source Model Context Protocol (MCP) que conecta asistentes de codificación con IA a la plataforma de automatización de flujos de trabajo n8n. Proporciona a herramientas como Claude Desktop, Claude Code, Cursor, Windsurf y VS Code un conocimiento estructurado y en tiempo real de todo el ecosistema de n8n —incluyendo 537 nodos principales + 547 nodos comunitarios (1.084 en total), 2.709 plantillas de flujos de trabajo y lógica de validación específica para IA.

Construido como una aplicación ligera en Node.js con una base de datos SQLite integrada, ofrece respuestas en menos de 12 ms y funciona en modo stdio o HTTP. Conéctalo una sola vez y permite que tu IA construya, valide, pruebe y despliegue flujos de trabajo completos de n8n sin copiar y pegar ni configuración manual.

Hay una versión alojada con un Chat Agent listo para usar disponible en n8n-mcp.com (nivel gratuito + planes de pago), mientras que el repositorio de GitHub sigue siendo completamente autoalojable bajo la licencia MIT.

Características principales

• Base de conocimiento completa de nodos — Acceso total a 1.084 nodos de n8n con 99 % de cobertura de propiedades, 63,6 % de cobertura de operaciones y 87 % de la documentación oficial (actualizada en menos de 48 horas tras nuevos lanzamientos de n8n).
• Búsqueda inteligente y descubrimiento — search_nodes, get_node (varios modos de detalle) y filtrado de nodos comunitarios por fuente (verificados/comunidad).
• Ejemplos del mundo real — 2.646 configuraciones extraídas previamente de plantillas populares.
• Validación avanzada — validate_node y validate_workflow con perfiles de agentes IA, comprobaciones en tiempo de ejecución y análisis de dependencias. Compatible con flujos de trabajo AI Agent de n8n v2.17+.
• Motor de plantillas — Busca y recupera más de 2.709 JSON de flujos de trabajo listos para usar con filtrado inteligente.
• Herramientas de gestión de n8n (conexión API opcional) — Crea, actualiza, prueba, ejecuta y corrige automáticamente flujos de trabajo directamente en tu instancia de n8n.
• Rendimiento y compatibilidad — ~12 ms de respuesta promedio, huella de memoria de 70–120 MB, compatible con cualquier versión de Node.js. Soporta modos stdio (Claude Desktop) y HTTP/SSE.
• Privacidad y seguridad — Telemetría anónima opcional (fácil de desactivar), sin credenciales codificadas, modos de seguridad para webhooks.

Instalación y configuración

Inicio rápido (npx – sin instalación)

npx n8n-mcp

Añádelo a tu claude_desktop_config.json de Claude Desktop con MCP_MODE=stdio.

Docker (recomendado para producción)

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

Nube (un clic)

Despliega gratis en Railway usando la plantilla del repositorio.

Compilación local completa

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

Variables de entorno opcionales: N8N_API_URL, N8N_API_KEY (para gestión directa de flujos), LOG_LEVEL=error, MCP_MODE=stdio.

Asistentes de IA compatibles

• Claude Desktop / Claude Code
• Cursor
• Windsurf
• VS Code + Codex
• Antigravity
• Cualquier cliente compatible con MCP (más de 20 herramientas vía servicio alojado)

Casos de uso

• Creación de flujos impulsada por IA — Describe “monitorear menciones en Twitter y publicar resúmenes en Slack con análisis de sentimiento” → la IA genera, valida y despliega el JSON completo.
• Mantenimiento de flujos existentes — La IA lee flujos en vivo, sugiere optimizaciones y aplica actualizaciones puntuales.
• Exploración de plantillas — Pide “la mejor plantilla de sincronización CRM usando nodos comunitarios” y recibe JSON listo para importar.
• Automatización empresarial — Conecta a instancias autoalojadas de n8n para generación segura y auditada de flujos a escala.
• Aprendizaje y prototipado — Usa herramientas de validación para enseñar a la IA las mejores prácticas antes del despliegue en producción.

MCP nativo de n8n vs n8n-mcp

El servidor MCP nativo de n8n (disponible en versiones recientes) expone tus propios flujos como herramientas. n8n-mcp es un servidor MCP externo complementario enfocado en el conocimiento de nodos de n8n y la creación asistida por IA. Úsalos juntos para obtener el máximo potencial: servidor nativo para disparar flujos + n8n-mcp para construcción inteligente de flujos.

Enlaces y recursos

• GitHub: czlonkowski/n8n-mcp
• Chat Agent alojado y Dashboard: n8n-mcp.com
• Nivel gratuito: 100 llamadas a herramientas/día (alojado) o ilimitado si autoalojas
• Documentación y ejemplos en el repositorio

n8n-mcp convierte cualquier asistente de codificación con IA en un experto completo en flujos de trabajo de n8n —al instante.