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의 전역 설치 프로그램이 중복된 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의 별칭입니다. 경로가 중요합니다. 바이너리는 pi-mcp(~/.bun/bin)로 PATH에 배치됩니다.

로컬 개발의 경우, 이 디렉터리에서 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.