n8n MCP Server

Name: n8n MCP Server
Author: leonardsellem

Ein Model Context Protocol (MCP)-Server, der es KI-Assistenten ermöglicht, über natürliche Sprache mit n8n-Workflows zu interagieren.

Überblick

Dieser MCP-Server bietet KI-Assistenten Tools und Ressourcen zur Verwaltung von n8n-Workflows und -Ausführungen. Er ermöglicht Assistenten:

Auflisten, Erstellen, Aktualisieren und Löschen von Workflows
Aktivieren und Deaktivieren von Workflows
Ausführen von Workflows und Überwachen ihres Status
Zugriff auf Workflow-Informationen und Ausführungsstatistiken

Related MCP server: MCP Toolkit

Installation

Voraussetzungen

Node.js 18 oder höher
n8n-Instanz mit aktiviertem API-Zugriff

Von npm installieren

npm install -g n8n-mcp-server

Von der Quelle installieren

# Clone the repository git clone https://github.com/leonardsellem/n8n-mcp-server.git cd n8n-mcp-server # Install dependencies npm install # Build the project npm run build # Optional: Install globally npm install -g .

Docker-Installation

Sie können den Server auch mit Docker ausführen:

# Pull the image docker pull leonardsellem/n8n-mcp-server # Run the container with your n8n API configuration docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \ -e N8N_API_KEY=your_n8n_api_key \ -e N8N_WEBHOOK_USERNAME=username \ -e N8N_WEBHOOK_PASSWORD=password \ leonardsellem/n8n-mcp-server

Konfiguration

Erstellen Sie eine .env Datei in dem Verzeichnis, in dem Sie den Server ausführen, und verwenden Sie .env.example als Vorlage:

cp .env.example .env

Konfigurieren Sie die folgenden Umgebungsvariablen:

Variable	Beschreibung	Beispiel
`N8N_API_URL`	Vollständige URL der n8n-API, einschließlich `/api/v1`	`http://localhost:5678/api/v1`
`N8N_API_KEY`	API-Schlüssel zur Authentifizierung mit n8n	`n8n_api_...`
`N8N_WEBHOOK_USERNAME`	Benutzername für die Webhook-Authentifizierung (bei Verwendung von Webhooks)	`username`
`N8N_WEBHOOK_PASSWORD`	Passwort für die Webhook-Authentifizierung	`password`
`DEBUG`	Debug-Protokollierung aktivieren (optional)	`true` oder `false`

Generieren eines n8n-API-Schlüssels

Öffnen Sie Ihre n8n-Instanz in einem Browser
Gehen Sie zu Einstellungen > API > API-Schlüssel
Erstellen Sie einen neuen API-Schlüssel mit entsprechenden Berechtigungen
Kopieren Sie den Schlüssel in Ihre .env Datei

Verwendung

Ausführen des Servers

Aus dem Installationsverzeichnis:

n8n-mcp-server

Oder bei globaler Installation:

n8n-mcp-server

Integration mit KI-Assistenten

Nachdem Sie den Server erstellt haben ( npm run build ), müssen Sie Ihren KI-Assistenten (z. B. VS Code mit der Claude-Erweiterung oder die Claude Desktop-App) für die Ausführung konfigurieren. Dies beinhaltet normalerweise die Bearbeitung einer JSON-Konfigurationsdatei.

Beispielkonfiguration (z. B. in VS Code

{ "mcpServers": { // Give your server a unique name "n8n-local": { // Use 'node' to execute the built JavaScript file "command": "node", // Provide the *absolute path* to the built index.js file "args": [ "/path/to/your/cloned/n8n-mcp-server/build/index.js" // On Windows, use double backslashes: // "C:\\path\\to\\your\\cloned\\n8n-mcp-server\\build\\index.js" ], // Environment variables needed by the server "env": { "N8N_API_URL": "http://your-n8n-instance:5678/api/v1", // Replace with your n8n URL "N8N_API_KEY": "YOUR_N8N_API_KEY", // Replace with your key // Add webhook credentials only if you plan to use webhook tools // "N8N_WEBHOOK_USERNAME": "your_webhook_user", // "N8N_WEBHOOK_PASSWORD": "your_webhook_password" }, // Ensure the server is enabled "disabled": false, // Default autoApprove settings "autoApprove": [] } // ... other servers might be configured here } }

Wichtige Punkte:

Ersetzen Sie /path/to/your/cloned/n8n-mcp-server/ durch den tatsächlichen absoluten Pfad, unter dem Sie das Repository geklont und erstellt haben.
Verwenden Sie das richtige Pfadtrennzeichen für Ihr Betriebssystem (Schrägstriche / für macOS/Linux, doppelte Backslashes \\ für Windows).
Stellen Sie sicher, dass Sie die richtige N8N_API_URL (einschließlich /api/v1 ) und N8N_API_KEY angeben.
Der Server muss erstellt werden ( npm run build ), bevor der Assistent die Datei build/index.js ausführen kann.

Verfügbare Tools

Der Server stellt die folgenden Tools bereit:

Verwenden von Webhooks

Dieser MCP-Server unterstützt die Ausführung von Workflows über n8n-Webhooks. So nutzen Sie diese Funktion:

Erstellen Sie einen durch Webhook ausgelösten Workflow in n8n.
Richten Sie die Basisauthentifizierung auf Ihrem Webhook-Knoten ein.
Verwenden Sie das Tool run_webhook , um den Workflow auszulösen, und übergeben Sie nur den Workflow-Namen.

Beispiel:

const result = await useRunWebhook({ workflowName: "hello-world", // Will call <n8n-url>/webhook/hello-world data: { prompt: "Hello from AI assistant!" } });

Die Webhook-Authentifizierung wird automatisch mithilfe der Umgebungsvariablen N8N_WEBHOOK_USERNAME und N8N_WEBHOOK_PASSWORD durchgeführt.

Workflow-Management

workflow_list : Listet alle Workflows auf
workflow_get : Details zu einem bestimmten Workflow abrufen
workflow_create : Einen neuen Workflow erstellen
workflow_update : Aktualisieren Sie einen vorhandenen Workflow
workflow_delete : Einen Workflow löschen
workflow_activate : Aktiviert einen Workflow
workflow_deactivate : Einen Workflow deaktivieren

Ausführungsmanagement

execution_run : Ausführen eines Workflows über die API
run_webhook : Führen Sie einen Workflow über einen Webhook aus
execution_get : Details einer bestimmten Ausführung abrufen
execution_list : Listet Ausführungen für einen Workflow auf
execution_stop : Stoppt eine laufende Ausführung

Ressourcen

Der Server stellt die folgenden Ressourcen bereit:

n8n://workflows/list : Liste aller Workflows
n8n://workflow/{id} : Details eines bestimmten Workflows
n8n://executions/{workflowId} : Liste der Ausführungen für einen Workflow
n8n://execution/{id} : Details einer bestimmten Ausführung

Entwicklung

Gebäude

npm run build

Ausführen im Entwicklungsmodus

npm run dev

Testen

npm test

Fusseln

npm run lint

Lizenz

MIT

n8n MCP Server

n8n MCP Server

Überblick

Installation

Voraussetzungen

Von npm installieren

Von der Quelle installieren

Docker-Installation

Konfiguration

Generieren eines n8n-API-Schlüssels

Verwendung

Ausführen des Servers

Integration mit KI-Assistenten

Verfügbare Tools

Verwenden von Webhooks

Workflow-Management

Ausführungsmanagement

Ressourcen

Entwicklung

Gebäude

Ausführen im Entwicklungsmodus

Testen

Fusseln

Lizenz

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API