Plateforme de Service Centralisée pour N8N (MCP)

Cette suite logicielle agit comme un Programme de Contrôle Maître (MCP) dédié à l'écosystème N8N, offrant des mécanismes sophistiqués pour l'assurance qualité des flux de travail et la création de ponts logiciels robustes vers des applications NextJS.

Capacités Fondamentales

• Audit de Flux de Travail : Évaluation systématique des configurations N8N par rapport aux standards établis :
• Adhésion aux schémas de désignation (nommage)
• Stratégies de gestion des exceptions et des erreurs
• Mesures de sécurité intégrées
• Optimisation des métriques de performance
• Exigences de documentation interne
• Connectivité NextJS : Automatisation de la génération d'interfaces pour les déclencheurs et les données N8N au sein d'architectures NextJS :
• Production automatisée de squelettes de routes API (API Routes)
• Compilation de spécifications OpenAPI/Swagger pour la documentation des contrats
• Génération typée (TypeScript) des modèles de données d'échange
• Création d'un client d'accès aux données pour simplifier l'intégration côté client
• Gouvernance des Instances N8N : API complète pour la manipulation des artefacts de flux de travail (inventaire, lecture détaillée, instanciation, modification, désactivation, exportation, chargement)
• Accès Direct au Cœur N8N : Interface programmatique pour exécuter des commandes avancées directement sur l'API interne de N8N.
• Référentiels de Modèles : Bibliothèque de schémas de flux de travail pré-validés pour des scénarios fréquents, incluant des connecteurs spécifiques comme Google Calendar.

Prérequis Techniques

• Environnement d'exécution Node.js (version minimale 16)
• Gestionnaire de paquets pnpm (version minimale 7)
• Une instance opérationnelle de N8N (hébergement local ou service managé, ex: Cloudron hébergé sur n8n.bienquoi.com)

Procédure de Mise en Place

1. Cloner le dépôt source ou naviguer vers le répertoire du projet.
2. Installer toutes les dépendances requises :

bash pnpm install

1. Initialiser le fichier de configuration :

bash cp .env.example .env

Configurer attentivement .env avec les identifiants et les URL d'accès à l'API de votre plateforme N8N.

Modalités d'Opération

Compilation du Projet

bash pnpm build

Lancement du Serveur d'Orchestration

bash pnpm start

Le service MCP sera actif et exposé typiquement sur http://localhost:3000 (ajustez selon la configuration spécifiée dans .env).

Intégration avec Outils Locaux (Ex: Claude Desktop)

Pour permettre à des assistants locaux d'interagir avec ce service, une configuration spécifique doit être ajoutée au fichier de configuration de l'outil hôte (par exemple, claude_desktop_config.json localisé dans %APPDATA%/Claude/) :

{ "mcpServers": { "n8n-mcp-server": { "command": "node", "args": ["/chemin/absolu/vers/mcp-n8n-server/dist/server.js"] } } }

Architecture Interne du Système

mcp-n8n-server/ ├── src/ # Code source principal │ ├── tools/ # Modules d'interaction MCP │ │ ├── N8nApiTool.ts # Interface de bas niveau avec l'API N8N │ │ ├── WorkflowManagerTool.ts # Services de gestion complète des artefacts de flux │ │ ├── NextJSIntegrationTool.ts # Générateur de squelettes NextJS │ │ ├── WorkflowValidatorTool.ts # Moteur d'application des règles de conformité │ │ └── ... │ ├── validators/ # Bibliothèques de règles de validation spécifiques │ │ ├── naming.js # Conformité des conventions de dénomination │ │ ├── errorHandling.js # Robustesse de la gestion des exceptions │ │ ├── security.js # Évaluation des risques de sécurité │ │ ├── performance.js # Analyse des goulots d'étranglement potentiels │ │ └── documentation.js # Vérification de la complétude des métadonnées │ ├── resources/ # Contenus partagés et statiques │ └── server.ts # Point d'entrée et initialisation du serveur d'écoute ├── dist/ # Sortie du processus de compilation TypeScript ├── public/ # Assets statiques ├── output/ # Répertoire destiné aux artefacts générés par les outils ├── .env.example # Fichier modèle pour les variables d'environnement └── README.md # Documentation actuelle

Exemples d'Invocation des Utilitaires

1. N8nApiTool (Interaction brute avec l'API)

typescript // Requête pour lister les flux actifs { "method": "GET", "endpoint": "/workflows", "params": "?active=true" }

2. WorkflowManagerTool (Administration des ressources)

typescript // Action : récupérer la liste des flux marqués comme 'production' { "action": "list", "tags": "production" }

3. NextJSIntegrationTool (Génération de code de liaison)

typescript // Générer les composants NextJS pour le workflow ID '123' { "workflowId": "123", "outputDir": "./mon-app-nextjs/api/generated", "generateTypes": true, "generateOpenAPI": true }

4. WorkflowValidatorTool (Application des standards de qualité)

typescript // Valider un flux sérialisé contre trois critères majeurs avec une tolérance faible { "workflow": "{...contenu sérialisé du workflow...}", "validators": ["naming", "errorHandling", "security"], "strictness": "high" }

Participation Communautaire

Nous encourageons vivement les contributions ! Veuillez soumettre toute anomalie via une 'issue' ou proposer des améliorations via une 'pull request'.

Licence

Sous les termes de la licence MIT.