Skip to main content
Glama

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 SettingsAPI 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

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/businessarchi/n8n-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server