pi-mcp

pi のコーディングエージェントツールを公開する MCP サーバー：

read、bash、edit、write、grep、find、ls

Bun と @modelcontextprotocol/server v2 で構築されています。2026-07-28 世代（server/discover）と 2025 世代の initialize の両方に対応しています。

要件

• Bun >= 1.2

• PATH 上の rg と fd（grep / find で使用。ダウンロードはされません）

インストール

絶対パスを使用してください。. を渡さないでください — Bun のグローバルインストーラーが ~/.bun/install/global/package.json / bun.lock に重複した pi-mcp キーと空の "": "." エントリを書き込む可能性があります（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 のエイリアスです。重要なのはパスです。バイナリは pi-mcp として PATH に配置されます（~/.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

リスナーに JSON-RPC を POST します。最新（2026-07-28）のクライアントは server/discover に加えて、リクエストごとの _meta エンベロープと Mcp-Method / MCP-Protocol-Version ヘッダーを使用します。2025 年のクライアントは initialize を使用します。

ツール

実行動作は pi のコーディングエージェントツールから取られています。TUI レンダリング、photon 画像リサイズ、rg / fd の自動ダウンロードは含まれていません。

開発

bun install
bun src/cli.ts --help

ランタイム依存関係：@modelcontextprotocol/server、zod、diff。