Skip to main content
Glama

mcp-n8n-builder

mcp-n8n-builder

Ein Model Context Protocol (MCP)-Server zur programmgesteuerten Erstellung und Verwaltung von n8n-Workflows. Dieser Server bietet Tools und Ressourcen für die Interaktion mit der REST-API von n8n. Dadurch können KI-Assistenten Workflows ohne direkte Benutzereingriffe erstellen, ändern und verwalten.

Merkmale

  • 🔄 Workflow-Management : Erstellen, Lesen, Aktualisieren, Löschen, Aktivieren und Deaktivieren von Workflows
  • 📊 Ausführungsverwaltung : Auflisten und Abrufen von Details zur Workflow-Ausführung
  • Schemavalidierung : Umfassende Validierung mit Zod für Eingabe- und Ausgabedaten
  • 🔍 Knotenvalidierung : Validiert Knotentypen vor der Workflow-Erstellung anhand der verfügbaren Knoten von n8n, um Fehler zu vermeiden
  • 🤔 Intelligente Vorschläge : Bietet Vorschläge für ähnliche Knotentypen, wenn ungültige Knoten erkannt werden
  • 🛠️ Fehlerbehandlung : Detaillierte Fehlermeldungen zur Fehlerbehebung
  • 📝 Dokumentation : Umfangreiche Dokumentation für alle Tools und Ressourcen
  • 🔍 Suchen und Filtern : Filtern Sie Workflows nach Name, Tags oder aktivem Status

Konfiguration

Dieser Server muss über Ihren MCP-Client konfiguriert werden. Hier sind Beispiele für verschiedene Umgebungen:

Cline-Konfiguration

Fügen Sie dies zu Ihren Cline MCP-Einstellungen hinzu:

{ "mcpServers": { "n8n-workflow-builder": { "command": "npx", "args": ["-y", "mcp-n8n-builder"], "env": { "N8N_HOST": "http://localhost:5678/api/v1", "N8N_API_KEY": "your-n8n-api-key", "OUTPUT_VERBOSITY": "concise" // Options: 'concise' or 'full' } } } }

Claude Desktop mit WSL-Konfiguration

Fügen Sie für WSL-Umgebungen Folgendes zu Ihrer Claude Desktop-Konfiguration hinzu:

{ "mcpServers": { "n8n-workflow-builder": { "command": "wsl.exe", "args": [ "bash", "-c", "N8N_HOST=http://localhost:5678/api/v1 N8N_API_KEY=your-n8n-api-key OUTPUT_VERBOSITY=concise npx -y mcp-n8n-builder" ] } } }

Umgebungsvariablen

Der Server kann mithilfe von Umgebungsvariablen konfiguriert werden:

VariableBeschreibungStandard
N8N_HOSTURL der n8n-APIhttp://localhost:5678/api/v1
N8N_API_KEYAPI-Schlüssel für die n8n-Authentifizierung""
SERVER_NAMEName des MCP-Servers"n8n-workflow-builder"
SERVER_VERSIONVersion des MCP-ServersPaketversion
LOG_LEVELProtokollierungsebene"info"
CACHE_ENABLEDCaching aktivierenfalse
CACHE_TTLCache-TTL in Sekunden300
OUTPUT_VERBOSITYAusführlichkeitsgrad der Ausgabe ( concise oder full )"concise"

MCP-Werkzeuge

Knotenverwaltung

  • list_available_nodes : Listet alle verfügbaren Knoten in der n8n-Instanz auf. WICHTIG : Verwenden Sie dieses Tool VOR dem Erstellen oder Aktualisieren von Workflows, um sicherzustellen, dass Sie nur gültige Knotentypen verwenden. Dies hilft, Fehler zu vermeiden, die durch die Verwendung von Knotentypen entstehen, die in der aktuellen n8n-Instanz nicht vorhanden sind.

Workflow-Management

  • list_workflows : Listet alle Workflows von n8n mit ihren grundlegenden Informationen auf, einschließlich ID, Name, Status, Erstellungsdatum und Tags. Die Ergebnisse können nach aktivem Status, Tags oder Namen gefiltert werden.
  • create_workflow : Erstellt einen neuen Workflow in n8n mit den angegebenen Knoten und Verbindungen. Gibt den erstellten Workflow mit der zugewiesenen ID zurück. Überprüft, ob alle Knotentypen in der n8n-Instanz vorhanden sind.
  • get_workflow : Ruft vollständige Details eines bestimmten Workflows anhand seiner ID ab, einschließlich aller Knoten, Verbindungen, Einstellungen und Metadaten.
  • update_workflow : Aktualisiert einen vorhandenen Workflow mit der neuen Konfiguration. Die gesamte Workflow-Struktur muss bereitgestellt werden, nicht nur die zu ändernden Teile. Überprüft, ob alle Knotentypen in der n8n-Instanz vorhanden sind.
  • delete_workflow : Löscht einen Workflow anhand seiner ID dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden.
  • activate_workflow : Aktiviert einen Workflow anhand seiner ID und ermöglicht so die automatische Ausführung basierend auf seinem Auslöser.
  • deactivate_workflow : Deaktiviert einen Workflow anhand seiner ID und verhindert so, dass er automatisch ausgeführt wird.

Ausführungsmanagement

  • list_executions : Listet den Workflow-Ausführungsverlauf mit Details zu Erfolg/Fehler, Dauer und Zeitstempeln auf. Die Ergebnisse können nach Workflow-ID und Status gefiltert und auf eine bestimmte Anzahl begrenzt werden.
  • get_execution : Ruft detaillierte Informationen zu einer bestimmten Workflow-Ausführung ab, einschließlich Ausführungszeit, Status und optional der vollständigen Daten, die in jedem Schritt verarbeitet werden.

MCP-Ressourcen

  • n8n://workflows : Liste aller Workflows in n8n
  • n8n://workflows/{id} : Details eines bestimmten n8n-Workflows
  • n8n://executions/{id} : Details einer bestimmten n8n-Workflow-Ausführung

Entwicklung

Aufstellen

  1. Klonen Sie das Repository
  2. Installieren Sie Abhängigkeiten:
npm install
  1. Erstellen Sie das Projekt:
npm run build
  1. Im Entwicklungsmodus ausführen:
npm run dev

Veröffentlichen

Das Projekt verwendet Änderungssätze zur Versionsverwaltung. So veröffentlichen Sie:

  1. Erstellen Sie einen Änderungssatz:
npm changeset
  1. Versionieren Sie das Paket:
npm changeset version
  1. Auf npm veröffentlichen:
npm release

Beitragen

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

Lizenz

MIT-Lizenz – Einzelheiten finden Sie in der Datei LICENSE .

Danksagung

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

🪄 MCP-Server zur programmgesteuerten Erstellung und Verwaltung von n8n-Workflows. Ermöglicht KI-Assistenten das Erstellen, Ändern und Verwalten von Workflows ohne direkte Benutzereingriffe durch einen umfassenden Satz von Tools und Ressourcen für die Interaktion mit der REST-API von n8n.

  1. Merkmale
    1. Konfiguration
      1. Cline-Konfiguration
      2. Claude Desktop mit WSL-Konfiguration
      3. Umgebungsvariablen
    2. MCP-Werkzeuge
      1. Knotenverwaltung
      2. Workflow-Management
      3. Ausführungsmanagement
    3. MCP-Ressourcen
      1. Entwicklung
        1. Aufstellen
        2. Veröffentlichen
      2. Beitragen
        1. Lizenz
          1. Danksagung

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              An MCP server enabling secure interaction with n8n workflows, executions, and settings via the Model Context Protocol, designed for integration with Large Language Models (LLMs).
              Last updated -
              33
              65
              34
              TypeScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants to interact with n8n workflows through natural language, supporting actions like listing, creating, updating, executing and monitoring workflows.
              Last updated -
              388
              464
              TypeScript
              MIT License
              • Apple
              • Linux
            • -
              security
              F
              license
              -
              quality
              A Master Control Program server that provides workflow validation tools and best practices for n8n automation projects, including workflow management, NextJS integration, and API access.
              Last updated -
              TypeScript

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/spences10/mcp-n8n-builder'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server