pi-mcp

MCP-сервер, предоставляющий инструменты coding-agent из pi:

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

Создан на Bun и @modelcontextprotocol/server v2. Поддерживает как эру 2026-07-28 (server/discover), так и initialize эры 2025.

Требования

• Bun >= 1.2

• rg и fd в PATH (используются grep / find; не скачиваются)

Установка

Используйте абсолютный путь. Не передавайте . — глобальный установщик Bun может записать дублирующий ключ pi-mcp и пустую запись "": "." в ~/.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 — это псевдоним bun add -g; важнее всего путь. Бинарник попадает в PATH как pi-mcp (~/.bun/bin).

Для локальной разработки вместо этого выполните bun link в этом каталоге.

Использование

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 нельзя комбинировать с --http / --host / --port.

Логируйте в stderr. stdout — канал протокола stdio.

Конфигурация хоста (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 на слушатель. Современные (2026-07-28) клиенты используют server/discover вместе с обёрткой _meta на каждый запрос и заголовками Mcp-Method / MCP-Protocol-Version. Клиенты 2025 используют initialize.

Инструменты

Поведение выполнения взято из инструментов coding-agent в pi. TUI-рендеринг, изменение размера изображений photon и автоматическая загрузка rg/fd не включены.

Разработка

bun install
bun src/cli.ts --help

Зависимости времени выполнения: @modelcontextprotocol/server, zod, diff.