n8n Workflow Builder MCP

Ein Model Context Protocol (MCP) Server zum Erstellen und Bearbeiten von n8n-Workflows. Erstellen Sie n8n-Workflows einfach per KI-Prompt – funktioniert mit Claude Code, VS Code, Cursor und jedem MCP-kompatiblen Client.

DEMO-VIDEO:

Cursor-Regeln

• Die Datei mit den Regeln befindet sich unter rules/n8n-mcp-server-rules.mdc

Related MCP server: MCP- N8N

Hauptfunktionen

• Workflow-Verwaltung: Erstellen, Aktualisieren und Ausführen von n8n-Workflows per Programmcode (Ausführung ist noch nicht implementiert)

• Node-Discovery: Erkunden Sie verfügbare n8n-Nodes und deren Funktionen

• Verbindungsverwaltung: Erstellen Sie Verbindungen zwischen Workflow-Nodes

• KI-Integration: Spezielle Tools zum Verbinden von KI-Komponenten in Workflows

• KI-freundliche Schnittstelle: Speziell für die Interaktion mit KI-Agenten entwickelt

• n8n-Versionsverwaltung: Automatische Versionserkennung und Kompatibilitätsbehandlung – unterstützt über 184 n8n-Versionen (1.86.0 – 2.6.2) mit dynamischer Node-Filterung und "Closest Lower Version"-Matching für Abwärtskompatibilität

Voraussetzungen

• Node.js (v18 oder höher)

• npm (für den npx-Befehl)

• Ein MCP-kompatibler Client (Claude Code, VS Code, Cursor, etc.)

Installation & Einrichtung

Abrufen Ihres n8n-API-Schlüssels

1. Öffnen Sie Ihre n8n-Instanz im Browser

2. Gehen Sie zu Settings > API Keys

3. Klicken Sie auf Create API Key

4. Kopieren Sie den generierten Schlüssel und verwenden Sie ihn in Ihrer Konfiguration

Claude Code (Empfohlen)

Fügen Sie den MCP-Server über die Claude Code CLI hinzu:

claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder-mcp

Setzen Sie dann die Umgebungsvariablen:

claude mcp add n8n-workflow-builder \
  -e N8N_API_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-n8n-api-key-here \
  -- npx -y n8n-workflow-builder-mcp

N8N_VERSION ist optional – der Server erkennt sie automatisch über die API.

VS Code / Cursor

Fügen Sie dies zu Ihrer MCP-Konfigurationsdatei hinzu (.vscode/mcp.json für VS Code, .cursor/mcp.json für Cursor):

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["-y", "n8n-workflow-builder-mcp"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-n8n-api-key-here"
      }
    }
  }
}

Starten Sie Ihre IDE neu, damit die Änderungen wirksam werden.

Entwicklungsinstallation

Für die Entwicklung oder lokale Tests klonen und bauen Sie aus dem Quellcode:

git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git
cd n8n-workflow-builder-mcp
npm install
npm run build

Verweisen Sie dann Ihren MCP-Client auf den gebauten Einstiegspunkt:

# Claude Code
claude mcp add n8n-workflow-builder -- node /absolute/path/to/n8n-workflow-builder-mcp/dist/index.js

# VS Code / Cursor — use the same JSON config above with "command": "node" and "args": ["/absolute/path/to/dist/index.js"]

Für die Entwicklung mit automatischem Rebuild:

npm run dev

Verfügbare MCP-Tools

Der Server stellt die folgenden Tools für die Arbeit mit n8n-Workflows bereit:

Kern-Workflow-Verwaltung

Node-Verwaltung

Verbindungsverwaltung

Workflow-Planung & Komposition

Parameter-Verwaltung

Vorlagen & Discovery

Validierungsverhalten

validate_workflow stuft Warnungen zu Fehlern hoch und schlägt zusätzlich fehl, wenn ein aktivierter Node nicht (direkt oder über KI-Ports) mit der Hauptkette verbunden ist, die am abgeleiteten startNode beginnt. Verwenden Sie connect_from/connect_to oder add_ai_connections, um die Konnektivität zu korrigieren.

Fehlerbehebung

Allgemein

1. Überprüfen Sie Ihre MCP-Konfiguration — stellen Sie sicher, dass das JSON gültig ist und der Servername übereinstimmt.

2. Aktualisieren Sie Node.js auf die neueste LTS-Version.

3. Leeren Sie den npm-Cache, falls npx fehlschlägt: npm cache clean --force

4. Versuchen Sie eine globale Installation als Fallback: npm install -g n8n-workflow-builder-mcp

Claude Code

• Führen Sie claude mcp list aus, um zu überprüfen, ob der Server registriert ist.

• Überprüfen Sie die Protokolle mit claude mcp logs n8n-workflow-builder.

VS Code / Cursor

• Überprüfen Sie das Ausgabefenster (Output) — wählen Sie "MCP" aus dem Dropdown-Menü, um Server-Protokolle zu sehen.

• Stellen Sie sicher, dass der Server unter Settings > Features > MCP Servers aktiviert ist.

• Starten Sie die IDE nach Konfigurationsänderungen neu.

Projektstruktur

• /src: Hauptquellcode

• /src/tools: Implementierung der MCP-Tools

• /src/models: Datenmodelle

• /src/utils: Hilfsfunktionen

• /src/middleware: Authentifizierung und Middleware

• /config: Konfigurationsdateien

• /tests: Testdateien

• /workflow_nodes: n8n-Node-Definitionen

• /docs: Zusätzliche Dokumentation

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Branch (git checkout -b feature/amazing-feature)

3. Committen Sie Ihre Änderungen (git commit -m 'Add some amazing feature')

4. Pushen Sie den Branch (git push origin feature/amazing-feature)

5. Öffnen Sie einen Pull Request

Lizenz

MIT-Lizenz