n8n Workflow Builder MCP

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server zum Erstellen und Bearbeiten von n8n-Workflows JSON in der Cursor IDE. So lassen sich n8n-Workflows einfach durch KI-Eingabe im Chat erstellen.

DEMO-VIDEO:

Aktueller Stand der Umsetzung

Es befindet sich in der frühen Entwicklungsphase. Grundsätzlich funktioniert es – der MCP-Server erstellt eine JSON-Datei mit dem n8n-Workflow, die Sie kopieren und in den Workflow-Editor der n8n-Benutzeroberfläche einfügen können. Aktuelle Probleme:

• Manchmal geben LLM-Agenten falsche Parameter in die Anfrage ein. Ich möchte das Problem beheben .

• Manchmal funktioniert die Verbindung zwischen Knoten nicht. Ich arbeite an einer Lösung .

• Nicht alle Knotentypen funktionieren. Ich arbeite an einer Lösung .

• Die erste Eingabeaufforderung ist wichtig. Wenn sie nicht klar ist, wird der Agent den falschen Weg einschlagen. Ich werde eine Lösung dafür finden .

Hauptmerkmale

• Workflow-Management : Erstellen, aktualisieren und führen Sie n8n-Workflows programmgesteuert aus (Ausführen ist noch nicht implementiert)

• Knotenerkennung : Erkunden Sie verfügbare n8n-Knoten und ihre Funktionen

• Verbindungsverwaltung : Erstellen Sie Verbindungen zwischen Workflow-Knoten

• KI-Integration : Spezielle Tools zur Einbindung von KI-Komponenten in Workflows

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

Voraussetzungen

• Node.js (v14 oder höher)

• Cursor-IDE (v0.48 oder neuer)

• npm oder yarn

• TypeScript-Compiler (als Entwicklungsabhängigkeit über npm install installiert)

Installation

1. Klonen Sie das Repository:

   git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git cd n8n-workflow-builder-mcp

2. Installieren Sie Abhängigkeiten:

   npm install

3. Erstellen Sie das TypeScript-Projekt:

   npm run build

4. Machen Sie das MCP-Serverskript ausführbar (falls erforderlich):

   chmod +x dist/index.js

Ausführen des Servers

Starten Sie den MCP-Server:

Dadurch wird der kompilierte Code aus dist/index.js ausgeführt.

Für die Entwicklung mit automatischem Wiederaufbau und Neustart bei Änderungen:

Cursor-IDE-Integration

Es gibt zwei Möglichkeiten, den MCP-Server mit Cursor einzurichten:

Methode 1: Verwenden der Cursor-Einstellungs-Benutzeroberfläche (empfohlen)

1. Cursor-IDE starten

2. Gehen Sie zu Einstellungen > Funktionen > MCP-Server

3. Klicken Sie auf „Server hinzufügen“ und geben Sie den absoluten Pfad zur Datei dist/index.js an (z. B. /Users/yourname/n8n-workflow-builder-mcp/dist/index.js ).

4. Stellen Sie sicher, dass der Server aktiviert ist

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

Methode 2: Manuelle Konfiguration

1. Stellen Sie sicher, dass das Verzeichnis .cursor vorhanden ist:

   mkdir -p .cursor

2. Erstellen Sie die MCP-Konfigurationsdatei:

   cat > .cursor/mcp.json << 'EOF' { "mcpServers": { "n8n-workflow-builder": { "command": "node", "args": ["/absolute/path/to/n8n-workflow-builder-mcp/dist/index.js"] } } } EOF

   Stellen Sie sicher, dass Sie /absolute/path/to durch den tatsächlichen Pfad auf Ihrem System ersetzen.

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

Verfügbare MCP-Tools

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

Fehlerbehebung bei der Cursorintegration

Wenn Sie Probleme haben, den MCP-Server mit Cursor zum Laufen zu bringen, versuchen Sie diese Schritte:

1. Cursor neu starten : Schließen Sie Cursor nach dem Einrichten der MCP-Konfiguration vollständig und starten Sie es neu.

2. Überprüfen Sie die Cursor-MCP-Einstellungen :

   • Cursoreinstellungen öffnen

   • Gehen Sie zu Funktionen > MCP-Server

   • Stellen Sie sicher, dass Ihr Server aufgeführt und aktiviert ist

   • Wenn es aufgelistet ist, aber nicht funktioniert, klicken Sie auf die Schaltfläche „Aktualisieren“

3. Serverprotokolle prüfen : Suchen Sie im Terminal, in dem Sie den Server ausführen, oder im Cursor-Ausgabefenster nach Fehlern. Wählen Sie „Cursor MCP“ aus der Dropdown-Liste im Ausgabefenster, um MCP-spezifische Protokolle anzuzeigen.

4. Dateiberechtigungen überprüfen : Stellen Sie sicher, dass die Datei dist/index.js über Ausführungsberechtigungen verfügt.

5. Auf Portkonflikte prüfen : Wenn andere MCP-Server laufen, kann es zu Konflikten kommen. Prüfen Sie, ob andere Prozesse dieselben Ports verwenden.

6. Versuchen Sie eine globale Installation : Anstatt einen lokalen Pfad zu verwenden, können Sie versuchen, den Server global zu installieren:

   npm install -g n8n-workflow-builder-mcp

   Aktualisieren Sie dann die Datei .cursor/mcp.json um den globalen Befehl zu verwenden.

Häufige Probleme und Lösungen

„Client konnte nicht erstellt werden“

Dies geschieht normalerweise, wenn:

• Der MCP-Server läuft nicht

• Es besteht ein Verbindungsproblem zwischen Cursor und dem Server

• Der Server ist während der Initialisierung abgestürzt

Versuchen:

1. Ausführen des Testskripts, um sicherzustellen, dass der Server ordnungsgemäß funktioniert

2. Überprüfen der Serverprotokolle auf Fehler

3. Cursor neu starten

Der MCP-Server wird nicht im Cursor angezeigt.

Dies kann passieren, wenn:

• Die Datei .cursor/mcp.json ist nicht richtig formatiert

• Der Cursor hat die Konfigurationsänderung nicht erkannt

Versuchen:

1. Validieren des JSON-Formats Ihrer .cursor/mcp.json Datei

2. Cursor neu starten

3. Manuelle Auswahl des Servers in den Cursoreinstellungen (sofern er dort angezeigt wird)

Der MCP-Server wird angezeigt, aber die Tools sind nicht verfügbar

Dies kann passieren, wenn:

• Der Server registriert seine Tools nicht richtig

• Es gibt ein Problem mit der ListOfferings-Anfrage/Antwort

Versuchen:

1. Ausführen des Testskripts, um zu überprüfen, ob die Tools ordnungsgemäß registriert sind

2. Klicken Sie in den MCP-Servereinstellungen im Cursor auf die Schaltfläche „Aktualisieren“.

3. Überprüfen der Serverprotokolle auf Fehler

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

• /docs : Zusätzliche Dokumentation

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

1. Forken Sie das Repository

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

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

4. Pushen zum Zweig ( git push origin feature/amazing-feature )

5. Öffnen einer Pull-Anfrage

Lizenz

Arbeite mit Lizenz – Bestätigung vom n8n-Team erforderlich