pi-mcp

MCP-Server, der die Coding-Agent-Tools von pi bereitstellt:

read, bash, edit, write, grep, find, ls

Erstellt mit Bun und @modelcontextprotocol/server v2. Unterstützt sowohl die Ära 2026-07-28 (server/discover) als auch initialize aus der Ära 2025.

Voraussetzungen

• Bun >= 1.2

• rg und fd im PATH (verwendet von grep / find; werden nicht heruntergeladen)

Installation

Verwenden Sie einen absoluten Pfad. Übergeben Sie nicht . – Buns globaler Installer kann einen doppelten pi-mcp-Schlüssel und einen leeren Eintrag "": "." in ~/.bun/install/global/package.json / bun.lock schreiben (oven-sh/bun#19559, oven-sh/bun#24207).

bun add -g /absolute/path/to/pi-mcp
# same thing from the checkout:
bun add -g "$(pwd)"

bun install -g ist ein Alias für bun add -g; der Pfad ist entscheidend. Die Binärdatei landet als pi-mcp im PATH (~/.bun/bin).

Für die lokale Entwicklung verwenden Sie stattdessen bun link in diesem Verzeichnis.

Verwendung

pi-mcp                         # stdio (default)
pi-mcp --http --port 3000      # Streamable HTTP
pi-mcp --cwd /path/to/project
pi-mcp --readonly              # read, grep, find, ls
pi-mcp --tools read,grep,ls
pi-mcp --shell /bin/bash

--stdio kann nicht mit --http / --host / --port kombiniert werden.

Loggen Sie nach stderr. stdout ist der stdio-Protokollkanal.

Host-Konfiguration (stdio)

{
  "mcpServers": {
    "pi": {
      "command": "pi-mcp",
      "args": ["--cwd", "/path/to/project"]
    }
  }
}

HTTP

pi-mcp --http --host 127.0.0.1 --port 3000

POST JSON-RPC an den Listener. Moderne Clients (2026-07-28) verwenden server/discover sowie den _meta-Envelope pro Anfrage und die Header Mcp-Method / MCP-Protocol-Version. Clients von 2025 verwenden initialize.

Tools

Das Ausführungsverhalten stammt aus den Coding-Agent-Tools von pi. TUI-Rendering, Photon-Bildskalierung und automatische rg/fd-Downloads sind nicht enthalten.

Entwicklung

bun install
bun src/cli.ts --help

Laufzeitabhängigkeiten: @modelcontextprotocol/server, zod, diff.