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

# 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)

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

# 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

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) :

{
  "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 :

{
  "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

# 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