pi-mcp

Servidor MCP que expone las herramientas del agente de codificación pi:

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

Construido con Bun y @modelcontextprotocol/server v2. Sirve tanto la era 2026-07-28 (server/discover) como la initialize de 2025.

Requisitos

• Bun >= 1.2

• rg y fd en PATH (usados por grep / find; no se descargan)

Instalación

Usa una ruta absoluta. No pases . — el instalador global de Bun puede escribir una clave pi-mcp duplicada y una entrada vacía "": "." en ~/.bun/install/global/package.json / bun.lock (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 es un alias de bun add -g; la ruta es lo que importa. El binario se coloca en PATH como pi-mcp (~/.bun/bin).

Para desarrollo local, usa bun link en este directorio.

Uso

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 no se puede combinar con --http / --host / --port.

Registra en stderr. stdout es el canal del protocolo stdio.

Configuración del host (stdio)

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

HTTP

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

Envía JSON-RPC por POST al listener. Los clientes modernos (2026-07-28) usan server/discover más el envoltorio _meta por solicitud y las cabeceras Mcp-Method / MCP-Protocol-Version. Los clientes de 2025 usan initialize.

Herramientas

El comportamiento de ejecución se toma de las herramientas del agente de codificación de pi. El renderizado TUI, el redimensionamiento de imágenes con photon y las descargas automáticas de rg/fd no están incluidos.

Desarrollo

bun install
bun src/cli.ts --help

Dependencias de ejecución: @modelcontextprotocol/server, zod, diff.