n8n-mcp

Aperçu

n8n-mcp est un serveur open-source Model Context Protocol (MCP) qui relie les assistants de codage IA à la plateforme d’automatisation de workflows n8n. Il fournit à des outils comme Claude Desktop, Claude Code, Cursor, Windsurf et VS Code une connaissance structurée et en temps réel de l’ensemble de l’écosystème n8n — incluant 537 nœuds principaux + 547 nœuds communautaires (1 084 au total), 2 709 templates de workflows et une logique de validation spécifique à l’IA.

Développé comme une application Node.js légère avec une base de données SQLite intégrée, il offre des réponses en moins de 12 ms et fonctionne en mode stdio ou HTTP. Connectez-le une seule fois et laissez votre IA construire, valider, tester et déployer des workflows n8n complets sans copier-coller ni configuration manuelle.

Une version hébergée avec un Chat Agent prêt à l’emploi est disponible sur n8n-mcp.com (offre gratuite + plans payants), tandis que le dépôt GitHub reste entièrement auto-hébergeable sous licence MIT.

Fonctionnalités principales

• Base de connaissance complète des nœuds — Accès total aux 1 084 nœuds n8n avec 99 % de couverture des propriétés, 63,6 % de couverture des opérations et 87 % de la documentation officielle (mise à jour en moins de 48 h après chaque nouvelle version de n8n).
• Recherche intelligente et découverte — search_nodes, get_node (plusieurs niveaux de détail) et filtrage des nœuds communautaires par source (vérifiés/communauté).
• Exemples réels — 2 646 configurations extraites au préalable à partir de templates populaires.
• Validation avancée — validate_node et validate_workflow avec profils d’agents IA, vérifications à l’exécution et analyse des dépendances. Compatible avec les workflows AI Agent de n8n v2.17+.
• Moteur de templates — Recherche et récupération de plus de 2 709 JSON de workflows prêts à l’emploi avec filtrage intelligent.
• Outils de gestion n8n (connexion API optionnelle) — Créer, mettre à jour, tester, exécuter et corriger automatiquement des workflows directement dans votre instance n8n.
• Performances et compatibilité — ~12 ms de temps de réponse moyen, empreinte mémoire de 70–120 Mo, compatible avec toutes les versions de Node.js. Supporte les modes stdio (Claude Desktop) et HTTP/SSE.
• Confidentialité et sécurité — Télémesure anonyme optionnelle (facilement désactivable), aucune clé codée en dur, modes de sécurité pour les webhooks.

Installation et configuration

Démarrage rapide (npx – sans installation)

npx n8n-mcp

Ajoutez-le à votre fichier claude_desktop_config.json de Claude Desktop avec MCP_MODE=stdio.

Docker (recommandé en production)

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

Cloud (en un clic)

Déployez gratuitement sur Railway via le template du dépôt.

Build local complet

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

Variables d’environnement optionnelles : N8N_API_URL, N8N_API_KEY (pour la gestion directe des workflows), LOG_LEVEL=error, MCP_MODE=stdio.

Assistants IA compatibles

• Claude Desktop / Claude Code
• Cursor
• Windsurf
• VS Code + Codex
• Antigravity
• Tout client compatible MCP (plus de 20 outils via le service hébergé)

Cas d’usage

• Création de workflows pilotée par IA — Décrivez « surveiller les mentions Twitter et publier des résumés sur Slack avec analyse de sentiment » → l’IA génère, valide et déploie le JSON complet.
• Maintenance de workflows existants — L’IA lit les workflows en direct, propose des optimisations et applique des mises à jour ciblées.
• Exploration de templates — Demandez « le meilleur template de synchronisation CRM utilisant des nœuds communautaires » et recevez un JSON prêt à importer.
• Automatisation en entreprise — Connectez-vous à des instances n8n auto-hébergées pour générer des workflows sécurisés et auditables à grande échelle.
• Apprentissage et prototypage — Utilisez les outils de validation pour enseigner à l’IA les meilleures pratiques avant un déploiement en production.

MCP natif de n8n vs n8n-mcp

Le serveur MCP natif de n8n (disponible dans les versions récentes) expose vos propres workflows comme outils. n8n-mcp est un serveur MCP externe complémentaire centré sur la connaissance des nœuds n8n et la création assistée par IA. Utilisez-les ensemble pour une puissance maximale : serveur natif pour déclencher des workflows + n8n-mcp pour une construction intelligente des workflows.

Liens et ressources

• GitHub : czlonkowski/n8n-mcp
• Chat Agent hébergé & Dashboard : n8n-mcp.com
• Offre gratuite : 100 appels d’outils/jour (hébergé) ou illimité en auto-hébergement
• Documentation et exemples dans le dépôt

n8n-mcp transforme n’importe quel assistant de codage IA en expert complet des workflows n8n — instantanément.