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:

Variable	Beschreibung	Standard
`N8N_HOST`	URL der n8n-API	`http://localhost:5678/api/v1`
`N8N_API_KEY`	API-Schlüssel für die n8n-Authentifizierung	`""`
`SERVER_NAME`	Name des MCP-Servers	`"n8n-workflow-builder"`
`SERVER_VERSION`	Version des MCP-Servers	Paketversion
`LOG_LEVEL`	Protokollierungsebene	`"info"`
`CACHE_ENABLED`	Caching aktivieren	`false`
`CACHE_TTL`	Cache-TTL in Sekunden	`300`
`OUTPUT_VERBOSITY`	Ausfü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

Klonen Sie das Repository
Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie das Projekt:

npm run build

Im Entwicklungsmodus ausführen:

npm run dev

Veröffentlichen

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

Erstellen Sie einen Änderungssatz:

npm changeset

Versionieren Sie das Paket:

npm changeset version

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

Basierend auf dem Model Context Protocol
Unterstützt von n8n

mcp-n8n-builder

Integrations

mcp-n8n-builder

Merkmale

Konfiguration

Cline-Konfiguration

Claude Desktop mit WSL-Konfiguration

Umgebungsvariablen

MCP-Werkzeuge

Knotenverwaltung

Workflow-Management

Ausführungsmanagement

MCP-Ressourcen

Entwicklung

Aufstellen

Veröffentlichen

Beitragen

Lizenz

Danksagung

Tools

Related Resources

Related MCP Servers

n8n Workflow Builder MCP Server

n8n Workflow Builder MCP Server

n8n MCP Server

n8n MCP Server