cli2mcp

Status: v0.1 — frühe Veröffentlichung. Nur Stdio-Transport. APIs können sich vor 1.0 noch ändern.

Stellen Sie jedes Befehlszeilen-Binary als Model Context Protocol-Tool bereit, indem Sie dessen --help-Ausgabe parsen und beim Start ein JSON-Schema synthetisieren. Ein Befehl, kein Boilerplate.

Funktioniert mit jedem MCP-kompatiblen Client — Claude Desktop, ChatGPT (via OpenAI Agents SDK), Cursor, Gemini CLI, Cline, Windsurf, Continue, Zed und allem anderen, das den MCP stdio transport unterstützt.

npx cli2mcp <command>

Warum

Das Schreiben eines MCP-Servers für ein CLI, das Sie bereits besitzen, ist mechanische Arbeit: SDK instanziieren, Tool registrieren, Eingabeschema von Hand schreiben, Argumente marshallen, Subprozess starten, Ausgabe formatieren. Etwa 80–150 Zeilen TypeScript pro Binary, die sich immer wiederholen, wenn neue Tools herauskommen.

cli2mcp erledigt das mit einem Befehl. Das --help des CLIs selbst ist die Quelle der Wahrheit für das Schema — wenn rg morgen ein Flag hinzufügt, sieht die KI es morgen ohne Codeänderungen.

Related MCP server: MCP-OpenAPI

Installation

npm install -g cli2mcp
# or invoke without installing
npx cli2mcp <command>

Erfordert Node.js 22+.

Konfigurieren Sie Ihren MCP-Client

cli2mcp wird von Ihrem Client als Stdio-Subprozess gestartet. Fügen Sie einen Eintrag pro CLI hinzu, das Sie bereitstellen möchten.

Claude Desktop

Speicherort der Konfigurationsdatei:

{
  "mcpServers": {
    "ripgrep": {
      "command": "npx",
      "args": ["-y", "cli2mcp", "rg", "--name", "ripgrep"]
    },
    "jq": {
      "command": "npx",
      "args": ["-y", "cli2mcp", "jq"]
    }
  }
}

Starten Sie Claude Desktop nach dem Bearbeiten neu.

Andere Clients

Beziehen Sie sich auf die Dokumentation des jeweiligen Clients für den genauen Konfigurationspfad auf Ihrer Plattform — diese entwickeln sich weiter und es gibt keine Garantie, dass sie mit der obigen Tabelle übereinstimmen.

Schnelle Erfolge — Copy-Paste-Konfigurationen

Fügen Sie einen dieser Blöcke in den mcpServers-Block Ihres Clients ein (Pfade siehe oben pro Client). Jeder davon verpackt ein beliebtes CLI als MCP-Tool, das eine KI direkt aufrufen kann.

{
  "mcpServers": {
    "ripgrep": {
      "command": "npx",
      "args": ["-y", "cli2mcp", "rg", "--name", "ripgrep",
               "--description", "Recursively search files with regex"]
    },
    "jq": {
      "command": "npx",
      "args": ["-y", "cli2mcp", "jq",
               "--description", "Query and transform JSON via stdin"]
    },
    "pandoc": {
      "command": "npx",
      "args": ["-y", "cli2mcp", "pandoc",
               "--description", "Convert documents between markup formats"]
    },
    "sqlite3": {
      "command": "npx",
      "args": ["-y", "cli2mcp", "sqlite3",
               "--description", "Run SQL against a SQLite database file",
               "--cwd", "/path/to/safe/dir"]
    },
    "yt-dlp": {
      "command": "npx",
      "args": ["-y", "cli2mcp", "yt-dlp",
               "--description", "Download media from URLs",
               "--cwd", "/path/to/downloads",
               "--timeout", "300000"]
    }
  }
}

Jedes CLI muss bereits installiert sein und sich im PATH befinden. cli2mcp installiert diese nicht für Sie.

Vergleich

Der nächste Nachbar ist FastMCPs from_openapi — es deckt keine beliebigen CLI-Binaries ab. Stand April 2026 gibt es kein anderes veröffentlichtes Tool, das eine beliebige --help-Ausgabe mit einem Befehl in ein typisiertes MCP-Tool verwandelt.

Verifizierte Ziele

Diese CLIs werden durch die Test-Suite abgedeckt oder wurden manuell von Ende zu Ende getestet:

Andere POSIX-artige CLIs (z. B. ffmpeg, yt-dlp, pandoc, sqlite3, imagemagick) sollten voraussichtlich funktionieren, sind aber noch nicht durch Tests abgedeckt. Melden Sie Fehler in den Issues.

Wie --help zu einem JSON-Schema wird

Wenn das Parsen bei einem unkonventionellen --help fehlschlägt, greift cli2mcp auf ein einzelnes variadisches args-Positional zurück, sodass das Tool weiterhin nutzbar ist — das Modell erhält lediglich eine freie Argumentliste anstelle von typisierten Flags.

Optionen

cli2mcp <command> [options]

  --name <name>         Tool name shown to the AI           (default: <command>)
  --description <text>  Tool description shown to the AI    (default: first --help line)
  --timeout <ms>        Subprocess timeout per call         (default: 60000)
  --cwd <path>          Working directory for subprocess    (default: process.cwd())
  --env <KEY=VALUE>     Extra environment variables         (repeatable)
  --stderr <mode>       stderr handling:
                          include  →  appended to tool output (default)
                          drop     →  discarded
                          error    →  any stderr → isError: true
  -h, --help            Show help

Piping von stdin

Die reservierte Eingabeeigenschaft stdin wird an den Subprozess weitergeleitet:

{ "args": [".name"], "stdin": "{\"name\": \"cli2mcp\"}" }

Funktionsweise

cli2mcp rg
   │
   ├─ 1. spawn: rg --help          →  capture stdout + stderr
   ├─ 2. parse help text           →  CliShape { flags, positionals, description }
   ├─ 3. synthesize JSON Schema    →  inputSchema
   ├─ 4. register one MCP tool     →  name: "rg", schema: <above>
   └─ 5. start stdio MCP server    →  await client connection

On tools/call:
   { args, flags, stdin? }  →  argv builder  →  execa(rg, argv, { stdin })
                                                           │
                                          stdout (+ stderr) → content[text]

Nicht-null-Exit → { isError: true, content: [{ type: "text", text: <stderr> }] } (außer --stderr drop).

Sicherheit

cli2mcp ermöglicht es einem KI-Agenten, die von Ihnen bereitgestellten CLIs mit den vom Agenten gewählten Argumenten aufzurufen. Sie sind dafür verantwortlich, was diese CLIs auf Ihrem Computer tun können.

Praktische Hinweise:

• Stellen Sie nur CLIs bereit, deren Wirkungsbereich Sie akzeptieren. jq, rg, pandoc sind weitgehend sicher (schreibgeschützt, deterministisch). curl, ffmpeg --output, sqlite3, rm, kubectl, aws sind es nicht.

• Die KI ist nicht in einer Sandbox. Ein Prompt-Injection-Angriff könnte dazu führen, dass ein bereitgestelltes curl evil.example.com abruft, ein bereitgestelltes rm Dateien löscht usw.

• Verwenden Sie --cwd, um den Dateisystembereich einzuschränken, wenn Sie CLIs verpacken, die auf Dateien zugreifen.

• Verwenden Sie --env bewusst. Geben Sie keine Anmeldeinformationen weiter, auf die das Modell nicht zugreifen sollte.

• Stellen Sie niemals sh, bash, zsh, python -c oder irgendetwas mit eval-Semantik bereit — das umgeht alle Sicherheitsvorkehrungen, die cli2mcp bietet.

Das Schema-aus-Hilfe-Design reduziert das Risiko von fehlerhaftem argv, aber es eliminiert nicht das Risiko des Missbrauchs. Behandeln Sie jedes bereitgestellte CLI als delegierte Fähigkeit, nicht als Sandbox.

Fehlerbehebung

Das CLI hat kein --help-Flag. cli2mcp startet trotzdem mit einem einzelnen args-Positional. Die KI kann Argumente frei übergeben; Sie verlieren die typisierte Flag-Ableitung.

Das Schema ist leer / falsch. Führen Sie cli2mcp <command> manuell aus und untersuchen Sie die tools/list-Antwort (verwenden Sie npx @modelcontextprotocol/inspector). Die häufigste Ursache ist eine nicht standardmäßige Hilfe-Formatierung (keine --long-form-Flags, falsch ausgerichtete Spalten). Eröffnen Sie ein Issue mit der angehängten <command> --help-Ausgabe.

Der Subprozess hängt. Das Standard-Timeout von 60s beendet ihn. Erhöhen Sie es über --timeout. Wenn Ihr CLI interaktiv ist (auf ein TTY wartet), kann cli2mcp nicht helfen — leiten Sie die Eingabe stattdessen über stdin weiter.

Flag wird nicht übergeben. Setzen Sie --stderr include (Standard) und untersuchen Sie content[].text. Wenn das Flag nicht in argv erscheint, konnte der Hilfe-Parser es nicht extrahieren — erstellen Sie ein Issue.

Mitwirken

Fehlerberichte und Patches sind willkommen. Fixtures für neue CLIs (test/fixtures/help/<cli>.txt + ein Form-Test) sind die Beiträge mit der größten Hebelwirkung.

pnpm install
pnpm test         # vitest
pnpm typecheck    # tsc --noEmit
pnpm lint         # biome check

Star-Verlauf

Wenn cli2mcp Ihnen einen Nachmittag Arbeit beim Schreiben von MCP-Boilerplate erspart hat, hilft ein Stern anderen Leuten, es zu finden.

Autor

Erstellt von Ronie Neubauer — Principal Engineer, über 22 Jahre Erfahrung in der Bereitstellung von Produktionssystemen.

• GitHub: @RonieNeubauer

• Blog: ronieneubauer.com

• Issues & Ideen: github.com/RonieNeubauer/cli2mcp/discussions

Lizenz

MIT © 2026 Ronie Neubauer.