n8n MCP Server

# Serveur MCP pour n8n Ce projet est un serveur MCP (Master Control Program) pour n8n qui fournit des outils de validation de workflows et de bonnes pratiques pour vos projets d'automatisation n8n. ## Fonctionnalités - **Validation de workflows** : Vérifiez que vos workflows respectent les bonnes pratiques - Conventions de nommage - Gestion des erreurs - Sécurité - Performance - Documentation - **Intégration NextJS** : Générez des intégrations pour vos workflows n8n dans des applications NextJS - Génération automatique de routes API - Création de documentation OpenAPI/Swagger - Génération de types TypeScript - Client API pour faciliter l'intégration - **Gestion des workflows** : Interagissez avec vos workflows n8n (liste, récupération, création, mise à jour, suppression, export, import) - **API n8n** : Accédez directement à l'API n8n pour des opérations avancées - **Templates de workflows** : Utilisez des templates prêts à l'emploi pour différents cas d'usage, notamment Google Calendar ## Prérequis - Node.js (v16 ou supérieur) - pnpm (v7 ou supérieur) - Une instance n8n (locale ou distante comme votre instance Cloudron sur n8n.bienquoi.com) ## Installation 1. Clonez ce dépôt ou naviguez vers le dossier du projet 2. Installez les dépendances : ```bash pnpm install ``` 3. Configurez les variables d'environnement : ```bash cp .env.example .env ``` Modifiez le fichier `.env` avec vos informations de connexion à l'API n8n. ## Utilisation ### Construction du projet ```bash pnpm build ``` ### Démarrage du serveur ```bash pnpm start ``` Le serveur MCP sera accessible à l'adresse http://localhost:3000 (ou le port spécifié dans votre fichier .env). ### Utilisation avec Claude Desktop Pour utiliser ce serveur MCP avec Claude Desktop, vous devez configurer le fichier `claude_desktop_config.json` dans le dossier `%APPDATA%/Claude/` : ```json { "mcpServers": { "n8n-mcp-server": { "command": "node", "args": ["/chemin/absolu/vers/mcp-n8n-server/dist/server.js"] } } } ``` ## Structure du projet ``` mcp-n8n-server/ ├── src/ # Code source │ ├── tools/ # Outils MCP │ │ ├── N8nApiTool.ts # Outil pour interagir avec l'API n8n │ │ ├── WorkflowManagerTool.ts # Outil pour gérer les workflows │ │ ├── NextJSIntegrationTool.ts # Outil pour générer des intégrations NextJS │ │ ├── WorkflowValidatorTool.ts # Outil pour valider les workflows │ │ └── ... │ ├── validators/ # Validateurs de workflows │ │ ├── naming.js # Validateur de conventions de nommage │ │ ├── errorHandling.js # Validateur de gestion des erreurs │ │ ├── security.js # Validateur de sécurité │ │ ├── performance.js # Validateur de performance │ │ └── documentation.js # Validateur de documentation │ ├── resources/ # Ressources partagées │ └── server.ts # Point d'entrée du serveur ├── dist/ # Code compilé ├── public/ # Fichiers statiques ├── output/ # Répertoire pour les sorties des outils ├── .env.example # Exemple de fichier de configuration └── README.md # Documentation ``` ## Outils disponibles ### 1. N8nApiTool Interagit directement avec l'API n8n. ```typescript // Exemple d'utilisation { "method": "GET", "endpoint": "/workflows", "params": "?active=true" } ``` ### 2. WorkflowManagerTool Gère les workflows n8n (liste, récupère, crée, met à jour, supprime, exporte, importe). ```typescript // Exemple d'utilisation { "action": "list", "tags": "production" } ``` ### 3. NextJSIntegrationTool Génère des intégrations NextJS pour les workflows n8n. ```typescript // Exemple d'utilisation { "workflowId": "123", "outputDir": "./my-nextjs-app/pages/api", "generateTypes": true, "generateOpenAPI": true } ``` ### 4. WorkflowValidatorTool Valide les workflows n8n selon différents critères. ```typescript // Exemple d'utilisation { "workflow": "{...}", "validators": ["naming", "errorHandling", "security"], "strictness": "high" } ``` ## Contribution Les contributions sont les bienvenues ! N'hésitez pas à ouvrir une issue ou une pull request. ## Licence MIT