n8n Workflow Builder MCP Server

Dieses Projekt stellt einen MCP-Server zur Verwaltung von n8n-Workflows bereit. Es bietet Funktionen zum Auflisten, Erstellen, Aktualisieren, Löschen, Aktivieren und Deaktivieren von Workflows mithilfe definierter Tools.

Wichtig:
Diese Version unterstützt ausschließlich npm für die Paketverwaltung und den Betrieb des Servers. (Die npx-Unterstützung wird in einem zukünftigen Update wieder eingeführt.)

Anforderungen

• Node.js (v14+ empfohlen)

• npm

Related MCP server: n8n MCP Server

Ausführliche Installationsanleitung

1. Klonen Sie das Repository

Klonen Sie das Repository aus Ihrer bevorzugten Quelle. Beispiel:

git clone https://github.com/makafeli/n8n-workflow-builder.git

Navigieren Sie dann zum Projektverzeichnis:

cd /root/n8n-workflow-builder

2. Abhängigkeiten installieren

Installieren Sie die erforderlichen Abhängigkeiten mit npm:

npm install

Dieser Befehl lädt alle erforderlichen Pakete herunter und installiert sie, wie in der Datei package.json definiert.

3. Erstellen und Testen

Verwenden Sie zum Testen und Onlineschalten des Servers die folgenden Befehle:

• Erstellen Sie das Projekt:
  Dadurch werden die TypeScript-Dateien kompiliert und das ausführbare JavaScript im build -Verzeichnis erstellt.

  npm run build

• Starten Sie den MCP-Server:
  Starten Sie den Server mit:

  npm start

Der Server wird gestartet und stellt über stdio eine Verbindung her. In der Konsole werden Meldungen angezeigt, die den korrekten Start des Servers bestätigen.

4. Bereitstellung

Verwenden Sie zu Testzwecken und um den Server online zu bringen, die oben genannten Build- und Start-Befehle. Dieser grundlegende Workflow (Installieren, Erstellen, Starten) ist derzeit die empfohlene Methode.

5. Zusätzliche Konfiguration

Die Serverkonfiguration für Cline erfolgt über die Datei cline_mcp_settings.json . Stellen Sie sicher, dass die folgenden Umgebungsvariablen korrekt festgelegt sind:

• N8N_HOST : Ihre n8n-API-Host-URL.

• N8N_API_KEY : Ihr n8n-API-Schlüssel.

Beispielkonfiguration in cline_mcp_settings.json :

{
  "n8n-workflow-builder": {
    "command": "node",
    "args": ["/root/n8n-workflow-builder/build/index.js"],
    "env": {
      "N8N_HOST": "https://n8n.io/api/v1/",
      "N8N_API_KEY": "YOUR_N8N_API_KEY_HERE"
    },
    "disabled": false,
    "alwaysAllow": [
      "create_workflow",
      "create_workflow_and_activate",
      "update_workflow",
      "activate_workflow",
      "deactivate_workflow",
      "get_workflow",
      "delete_workflow"
    ],
    "autoApprove": []
  }
}

Verfügbare Funktionen

MCP-Werkzeuge

Die folgenden Tools sind auf dem Server definiert und können über Ihren MCP-Client aufgerufen werden:

Workflow-Management

• list_workflows : Listet alle Workflows von n8n auf.

• create_workflow : Erstellt einen neuen Workflow in n8n.

• get_workflow : Ruft einen Workflow anhand seiner ID ab.

• update_workflow : Aktualisiert einen vorhandenen Workflow.

• delete_workflow : Löscht einen Workflow anhand seiner ID.

• activate_workflow : Aktiviert einen Workflow anhand seiner ID.

• deactivate_workflow : Deaktiviert einen Workflow anhand seiner ID.

Ausführungsmanagement

• list_executions : Listet alle Workflow-Ausführungen mit optionalen Filtern auf.

• get_execution : Ruft Details einer bestimmten Ausführung anhand ihrer ID ab.

• delete_execution : Löscht eine Ausführung anhand ihrer ID.

MCP-Ressourcen

Der Server stellt außerdem die folgenden Ressourcen für einen effizienteren Kontextzugriff bereit:

Statische Ressourcen

• /workflows : Liste aller verfügbaren Workflows in der n8n-Instanz

• /execution-stats : Zusammenfassende Statistiken zu Workflow-Ausführungen

Dynamische Ressourcenvorlagen

• /workflows/{id} : Detaillierte Informationen zu einem bestimmten Workflow

• /executions/{id} : Detaillierte Informationen zu einer bestimmten Ausführung

Fehlerbehebung

• Stellen Sie sicher, dass Sie npm verwenden (diese Version unterstützt npx nicht).

• Wenn Probleme auftreten, versuchen Sie, das Build-Verzeichnis zu bereinigen und neu zu erstellen:

  npm run clean && npm run build

• Überprüfen Sie, ob Ihre Umgebungsvariablen in cline_mcp_settings.json korrekt sind.

Zukünftige Verbesserungen

• Wiedereinführung der NPX-Unterstützung.

• Zusätzliche Tools und Workflow-Funktionen.

• Weitere Verbesserungen bei Bereitstellung und Skalierung.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.