N8N MCP Server

# N8N MCP Server Serveur MCP (Model Context Protocol) pour gérer plusieurs instances N8N depuis Claude, VSCode ou tout autre client MCP. ## Fonctionnalités 11 outils MCP disponibles : | Outil | Description | |-------|-------------| | `n8n_list_instances` | Lister les instances N8N disponibles | | `n8n_list_workflows` | Lister les workflows | | `n8n_search_workflows` | Rechercher des workflows | | `n8n_get_workflow` | Récupérer un workflow | | `n8n_create_workflow` | Créer un workflow | | `n8n_update_workflow` | Mettre à jour un workflow | | `n8n_delete_workflow` | Supprimer un workflow | | `n8n_toggle_workflow` | Activer/désactiver un workflow | | `n8n_execute_workflow` | Exécuter un workflow | | `n8n_list_executions` | Lister les exécutions | | `n8n_get_execution` | Détails d'une exécution | ## Modes de transport Le serveur supporte deux modes de transport : | Mode | Usage | Variable | |------|-------|----------| | **SSE** (défaut) | Déploiement sur Coolify/Docker | `MCP_TRANSPORT=sse` | | **stdio** | Usage local (Claude Desktop) | `MCP_TRANSPORT=stdio` | ## Installation ### Prérequis - Node.js 18+ - Une ou plusieurs instances N8N avec API activée ### Installation locale ```bash # Cloner le repository git clone https://github.com/businessarchi/n8n-mcp-server.git cd n8n-mcp-server # Installer les dépendances npm install # Build npm run build ``` ## Configuration ### Variables d'environnement #### Option 1 : Configuration JSON (recommandé pour plusieurs instances) ```bash N8N_INSTANCES='[{"name":"prod","url":"https://n8n.example.com","apiKey":"your-api-key"},{"name":"dev","url":"https://n8n-dev.example.com","apiKey":"your-api-key"}]' ``` #### Option 2 : Configuration individuelle ```bash # Instance 1 N8N_INSTANCE_1_NAME=prod N8N_INSTANCE_1_URL=https://n8n.example.com N8N_INSTANCE_1_API_KEY=your-api-key # Instance 2 N8N_INSTANCE_2_NAME=dev N8N_INSTANCE_2_URL=https://n8n-dev.example.com N8N_INSTANCE_2_API_KEY=your-api-key ``` #### Option 3 : Instance unique ```bash N8N_URL=https://n8n.example.com N8N_API_KEY=your-api-key N8N_INSTANCE_NAME=default ``` ### Générer une clé API N8N 1. Aller dans **Settings** → **API** dans votre instance N8N 2. Créer une nouvelle clé API 3. Copier la clé et l'utiliser dans la configuration ## Utilisation ### Avec Claude Desktop (mode stdio) Ajouter dans `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows) : ```json { "mcpServers": { "n8n": { "command": "node", "args": ["/chemin/vers/n8n-mcp-server/dist/index.js"], "env": { "MCP_TRANSPORT": "stdio", "N8N_INSTANCES": "[{\"name\":\"prod\",\"url\":\"https://n8n.example.com\",\"apiKey\":\"xxx\"}]" } } } } ``` ### Avec un client MCP SSE (mode réseau) Une fois déployé sur Coolify, le serveur expose : | Endpoint | Description | |----------|-------------| | `GET /` | Informations sur le serveur | | `GET /health` | Health check | | `GET /sse` | Connexion SSE pour les clients MCP | | `POST /messages` | Envoi de messages au serveur | Configuration client MCP SSE : ```json { "mcpServers": { "n8n": { "transport": "sse", "url": "https://votre-serveur.coolify.io/sse" } } } ``` ## Déploiement sur Coolify ### Configuration Coolify 1. **Créer une nouvelle application** dans Coolify 2. **Source** : GitHub → Sélectionner ce repository 3. **Type de build** : Dockerfile 4. **Port exposé** : `3000` ### Variables d'environnement Coolify ``` N8N_INSTANCES=[{"name":"prod","url":"https://n8n.example.com","apiKey":"xxx"}] ``` Ou individuellement : ``` N8N_INSTANCE_1_NAME=prod N8N_INSTANCE_1_URL=https://n8n.example.com N8N_INSTANCE_1_API_KEY=your-api-key ``` ### Health Check Configurer le health check vers `/health` sur le port `3000`. ## Développement ```bash # Mode développement avec rechargement automatique npm run dev # Build npm run build # Démarrer en production (SSE par défaut) npm start # Démarrer en mode stdio MCP_TRANSPORT=stdio npm start ``` ## Architecture ``` src/ ├── index.ts # Point d'entrée MCP Server (SSE + stdio) ├── config.ts # Gestion de la configuration ├── n8n-client.ts # Client API N8N ├── tools.ts # Définitions des 11 outils MCP └── types.ts # Types TypeScript ``` ## Licence MIT