CLI + MCP

n8nac CLI & MCP Tools

CLI-first Wrapper für n8nac-Befehle — nutzbar von Terminal, AI Agents (via Bash) oder MCP-Clients mit dem gleichen Binary. Zwei Interfaces, eine Logik: im TTY-Modus als klassisches CLI, bei gepiptem stdin als MCP-Server mit 6 Tools für Workflow-Management.

GitHub Repository → Architektur ansehen

6 MCP Tools

7 CLI Commands

434 LOC

2 Interfaces

n8nac-tools Architecture

CLI mode:

$ n8nac-tools list

$ n8nac-tools push workflow.ts

$ n8nac-tools api GET /api/v1/workflows

MCP mode (stdin piped):

n8nac.list | n8nac.push | n8nac.pull

n8nac.verify | n8nac.search | n8n.api

Same binary, two interfaces

→ spawn n8nac / fetch n8n API → stdout

Architektur

Pipeline

Erkennung

Binary prüft ob stdin ein TTY ist — TTY bedeutet CLI-Modus, piped bedeutet MCP.

CLI-Modus

Befehle wie list, push, pull, verify werden direkt als n8nac-Wrapper ausgeführt.

MCP-Modus

JSON-RPC Requests werden auf die gleiche Logik gemappt und als Tool-Responses zurückgegeben.

API-Durchgriff

api-Befehl ermöglicht direkten Zugriff auf die n8n REST API mit Host-Parameter.

Tech Stack

Technologien

Runtime

Node.jsTypeScript

Protokoll

MCP (JSON-RPC)n8n REST API

Integration

n8nac CLIClaude CodeAI Agents

Engineering Decisions

Architektur-Entscheidungen

Entscheidung

CLI-First, MCP-Wrap

Zuerst als CLI gebaut, dann MCP-Adapter im gleichen Binary. Folgt ADR-0001: CLI-First Over MCP-Only — garantiert Nutzbarkeit ohne MCP-Client.

Entscheidung

TTY-Detection für Modus-Wahl

Keine Flags oder Konfiguration nötig. stdin.isTTY entscheidet automatisch ob CLI oder MCP — ein Binary für beide Anwendungsfälle.