@ryan_nookpi/pi-extension-claude-mcp-bridge

Bridge Claude Code MCP server configs into pi — auto-discovers tools from stdio/sse/http MCP servers.

Package details

extension

Install @ryan_nookpi/pi-extension-claude-mcp-bridge from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@ryan_nookpi/pi-extension-claude-mcp-bridge
Package
@ryan_nookpi/pi-extension-claude-mcp-bridge
Version
1.0.0
Published
Apr 22, 2026
Downloads
271/mo · 146/wk
Author
ryan_nookpi
License
MIT
Types
extension
Size
49.6 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

claude-mcp-bridge

Bridge Claude Code MCP server configurations into pi — auto-discovers and registers MCP tools from stdio, SSE, and streamable-HTTP servers.

What it does

  • Config auto-discovery — scans for MCP settings in priority order:
    • PI_MCP_CONFIG env var (single file override)
    • Scoped search from cwd upward: .pi/mcp.json, .mcp.json, backend/.mcp.json, frontend/.mcp.json
    • Global: ~/.mcp.json, ~/.claude.json
    • First-seen server name wins on duplicates
  • Server transportsstdio, sse, http (streamable-HTTP)
  • Tool registration — each MCP tool becomes a pi tool named mcp__<server>__<tool>
  • Tool toggle — enable/disable per-tool via /mcp-status overlay; persisted in ~/.pi/agent/claude-mcp-bridge-tools.json
  • Auto-reconnect — exponential backoff on unexpected disconnection (up to 5 attempts)
  • Status bar — footer shows MCP connected/total
  • Large payload handling — responses > 30 KB are saved to a temp file with a truncated preview

Commands

Command Description
/mcp-status Interactive overlay: server list → actions (Tools toggle, Reconnect)

Install

pi install npm:@ryan_nookpi/pi-extension-claude-mcp-bridge

Notes

  • ${ENV_NAME} in config values are expanded from environment variables.
  • After changing MCP config (add/remove/rename servers), run /reload.