n8n-workflow-builder-mcp

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