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
Related MCP server: n8n Workflow Builder MCP Server
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:
Claude Desktop mit WSL-Konfiguration
Fügen Sie für WSL-Umgebungen Folgendes zu Ihrer Claude Desktop-Konfiguration hinzu:
Umgebungsvariablen
Der Server kann mithilfe von Umgebungsvariablen konfiguriert werden:
Variable | Beschreibung | Standard |
| URL der n8n-API |
|
| API-Schlüssel für die n8n-Authentifizierung |
|
| Name des MCP-Servers |
|
| Version des MCP-Servers | Paketversion |
| Protokollierungsebene |
|
| Caching aktivieren |
|
| Cache-TTL in Sekunden |
|
| Ausführlichkeitsgrad der Ausgabe (
oder
) |
|
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 n8nn8n://workflows/{id}: Details eines bestimmten n8n-Workflowsn8n://executions/{id}: Details einer bestimmten n8n-Workflow-Ausführung
Entwicklung
Aufstellen
Klonen Sie das Repository
Installieren Sie Abhängigkeiten:
Erstellen Sie das Projekt:
Im Entwicklungsmodus ausführen:
Veröffentlichen
Das Projekt verwendet Änderungssätze zur Versionsverwaltung. So veröffentlichen Sie:
Erstellen Sie einen Änderungssatz:
Versionieren Sie das Paket:
Auf npm veröffentlichen:
Beitragen
Beiträge sind willkommen! Senden Sie gerne einen Pull Request.
Lizenz
MIT-Lizenz – Einzelheiten finden Sie in der Datei LICENSE .
Danksagung
Basierend auf dem Model Context Protocol
Unterstützt von n8n