N8N2MCP: automatisiertes Tool zur Konvertierung von n8n-Workflows auf MCP-Server

N8N2MCP ist ein Open-Source-Tool, das Benutzern helfen soll, n8n-Workflows in Modell-Kontext-Protokoll (MCP) Server. Es ermöglicht Benutzern, automatisierte Prozesse über den visuellen Editor von n8n zu erstellen und sie schnell als MCP-Server einzusetzen, die sich nahtlos in KI-Assistenten wie Claude, Cursor oder Super Chain integrieren. Benutzer können KI-Assistenten einfach so konfigurieren, dass sie diese Workflows als benutzerdefinierte Tools aufrufen. n8N2MCP bietet eine webbasierte Workflow-Management-Plattform und ein effizientes MCP-Routing-System für Entwickler oder Teams, die automatisierte Aufgaben schnell bereitstellen müssen. Das Projekt wird auf GitHub in einem Open-Source-Modell gehostet, das Nutzer dazu ermutigt, Code und Feedback beizutragen.

Funktionsliste

• Konvertieren Sie n8n-Workflows in MCP-Server, um Anrufe von KI-Assistenten zu unterstützen.
• Bietet eine Webschnittstelle für die einfache Verwaltung, Bereitstellung und Konfiguration von Workflows.
• Unterstützt die Bereitstellung mit einem Mausklick, um lokal gehostete MCP-Server zu erzeugen.
• Der integrierte MCP-Router gewährleistet eine effiziente Servererstellung und Anforderungsverarbeitung.
• Unterstützt die Integration mit Plattformen wie Claude, Cursor und Super Chain.
• Bietet Mechanismen für die Sicherheitsverwaltung, einschließlich der Verwaltung von Anmeldeinformationen, API-Schlüsselrotation und HTTPS-Unterstützung.
• Unterstützt die Supabase-Datenbank zur Speicherung von Benutzerkonfigurations- und Workflow-Daten.
• Verwenden Sie Playwright für die n8n-Authentifizierung und Browser-Automatisierung.

Hilfe verwenden

Einbauverfahren

Um das N8N2MCP zu verwenden, müssen Sie die Installation und Konfiguration lokal oder auf dem Server durchführen. Im Folgenden werden die einzelnen Schritte beschrieben:

1. Klonen der Codebasis
   Führen Sie den folgenden Befehl im Terminal aus, um das N8N2MCP-Projekt lokal zu klonen:

   git clone https://github.com/Super-Chain/N8N2MCP.git
   cd N8N2MCP
   

2. Installation von Abhängigkeiten
   Verwenden Sie den Python-Paketmanager, um die erforderlichen Abhängigkeiten für Ihr Projekt zu installieren:

   pip install -r requirements.txt
   

3. Playwright-Browser installieren
   N8N2MCP verlässt sich auf Playwright für die Authentifizierung und Automatisierung von n8n. Führen Sie den folgenden Befehl aus, um die Browser-Binärdatei zu installieren:

   playwright install
   

   Hinweis: Wenn Playwright nicht ordnungsgemäß installiert ist, verwendet das System die Standard-Anmeldedaten, was zu einer eingeschränkten Funktionalität führt.

4. Umgebungsvariablen konfigurieren
   Kopieren Sie die Beispiel-Umgebungskonfigurationsdatei und bearbeiten Sie sie:

   cp .env.example .env
   

   Öffnen mit einem Texteditor .env geben Sie die folgende Schlüsselkonfiguration ein:

   • Supabase-Konfiguration:

     SUPABASE_URL=https://your-project-id.supabase.co
     SUPABASE_KEY=your_supabase_anon_key
     SUPABASE_SERVICE_KEY=your_supabase_service_role_key
     

   • n8n Konfiguration:

     X_N8N_API_KEY=your_n8n_api_key
     N8N_BASE_URL=https://your-n8n-instance.com
     N8N_USERNAME=your_n8n_username
     N8N_PASSWORD=your_n8n_password
     

   • MCP-Router-Konfiguration:

     N8N_BUILDER_URL=http://localhost:6545
     FLASK_HOST=0.0.0.0
     FLASK_PORT=5000
     MCP_HOST=0.0.0.0
     MCP_PORT=6545
     

   Bitte ersetzen Sie diese durch die tatsächlichen Konfigurationswerte, um sicherzustellen, dass die n8n-Instanz und der Supabase-Dienst zugänglich sind.

5. Betrieb des MCP-Routers
   Starten Sie den MCP-Router, um die Anfrage zu bearbeiten:

   cd mcp_router
   python mcp_router.py --log-level debug
   

   Debug-Modus (--log-level debug) Detaillierte Protokolle können zur einfachen Fehlersuche eingesehen werden.

6. Prüfling
   Testen Sie, ob der Workflow-Parser und der MCP-Router ordnungsgemäß funktionieren:

   python -m agent_marketplace.n8n_workflow_parser
   python -m mcp_router.mcp_router
   

Hauptfunktionen

1. n8n-Workflows auf MCP-Server konvertieren

• Erstellen oder bearbeiten Sie Workflows in der n8n-Oberfläche und entwerfen Sie automatisierte Aufgaben mit dem visuellen Editor.
• Über die Webschnittstelle des N8N2MCP (die standardmäßig auf dem http://localhost:5000) n8n hochladen Arbeitsablauf JSON-Datei oder Vorlagenlink.
• Wenn Sie auf die Schaltfläche Bereitstellen klicken, analysiert das System den Workflow und generiert einen MCP-Server. Nach der Generierung gibt das System eine Server-URL zurück (z. B. http://localhost:6545).
• Fügen Sie diese URL in einen MCP-fähigen KI-Assistenten ein (z. B. den Claude (oder Cursor), um die Workflow-Funktionalität aufzurufen.

2. die Verwaltung des MCP-Servers

• Besuchen Sie den Agent Marketplace (Weboberfläche), um eine Liste der bereitgestellten MCP-Server anzuzeigen.
• Der Server kann angehalten, gelöscht oder neu konfiguriert werden und unterstützt die dynamische Anpassung von Workflow-Parametern.
• Verwenden Sie die Supabase-Datenbank, um Benutzerkonfigurationen und Daten zu verwalten und die Datenisolierung und -sicherheit zu gewährleisten.

3. die Integration von KI-Assistenten

• Fügen Sie die MCP-Server-URL als benutzerdefiniertes Werkzeug in Claude, Cursor oder Super Chain hinzu.
• Der KI-Assistent ruft den Server über das MCP-Protokoll auf, um Aufgaben im Arbeitsablauf auszuführen, z. B. Datenverarbeitung, API-Aufrufe oder Automatisierung.
• Beispiel: Wenn der Workflow die Möglichkeit bietet, eine E-Mail zu versenden, kann der AI Assistant den Versand der E-Mail direkt auslösen.

4. das Sicherheitsmanagement

• Wechseln Sie den n8n-API-Schlüssel und den Supabase-Schlüssel regelmäßig, um die Sicherheit zu gewährleisten.
• Aktivieren Sie HTTPS in Produktionsumgebungen und verwenden Sie SSL-Zertifikate, um Datenübertragungen zu schützen.
• Konfigurieren Sie Sicherheitsrichtlinien auf Zeilenebene (RLS), um die Isolierung von Benutzerdaten zu gewährleisten.

caveat

• Stellen Sie sicher, dass die n8n-Instanz in Betrieb ist und über die N8N_BASE_URL Zugang.
• Die Installation und Konfiguration von Playwright ist für die n8n-Authentifizierung von entscheidender Bedeutung, und eine fehlerhafte Konfiguration kann zu einer eingeschränkten Funktionalität führen.
• Der Debug-Modus von Flask kann zum Debuggen aktiviert werden:

  export FLASK_DEBUG=1
  

• Sonde .env Datei für alle Konfigurationselemente, um ein Scheitern der Bereitstellung aufgrund von Konfigurationsfehlern zu vermeiden.

Anwendungsszenario

1. Automatisierte Marketingaufgaben
   Entwickler können n8n-Workflows entwerfen, um die Zustellung von Marketing-E-Mails zu automatisieren oder Abonnentendaten zu analysieren. Nach der Konvertierung auf einen MCP-Server kann der KI-Assistent personalisierte E-Mails auf der Grundlage des Kundenverhaltens auslösen.
2. Datenverarbeitung und -integration
   Datenanalysten können N8N2MCP nutzen, um komplexe Datenverarbeitungsprozesse, wie das Crawlen von Daten aus APIs und deren Speicherung in Datenbanken, als MCP-Server für KI-Assistenten bereitzustellen, die diese zur Erstellung von Berichten aufrufen.
3. AI-Assistent-Erweiterung
   Claude oder Cursor Mit dem N8N2MCP können Anwender die KI-Funktionen erweitern, z. B. durch die Integration von n8n-Workflows in den KI-Assistenten zur Dateiverwaltung, Datenanalyse oder Codegenerierung.
4. Schnelles Prototyping
   Startups können den N8N2MCP nutzen, um schnell automatisierte Prototypen bereitzustellen, Geschäftsprozesse zu testen und die Funktionsfähigkeit von KI-Assistenten zu überprüfen.

QA

1. Welche KI-Assistenten werden von N8N2MCP unterstützt?
   Derzeit unterstützt es MCP-kompatible KI-Assistenten wie Claude, Cursor und Super Chain. Sie kann in Zukunft auf weitere Plattformen erweitert werden.
2. Erfordert die Nutzung n8n Fachwissen?
   Ein grundlegendes Verständnis der n8n-Workflow-Erstellung ist erforderlich, aber die Webschnittstelle von N8N2MCP vereinfacht den Bereitstellungsprozess ohne tiefgreifende Programmierkenntnisse.
3. Wie kann ich die Sicherheit meines Servers gewährleisten?
   Es wird empfohlen, HTTPS zu verwenden, API-Schlüssel regelmäßig zu wechseln, RLS-Richtlinien zu aktivieren und die Speicherung von Benutzeranmeldeinformationen auf der Serverseite zu vermeiden.
4. Was passiert, wenn Playwright nicht installiert werden kann?
   Überprüfen Sie die Netzwerkverbindungen, um den Betrieb sicherzustellen. playwright install Befehl. Wenn dies fehlschlägt, versuchen Sie, die Browser-Binärdatei manuell herunterzuladen, oder wenden Sie sich an den Community-Support.