nicobailon/pi-mcp-adapter

Pi MCP Adapter 是 Pi AI 編碼代理的插件。它解決了實際痛點：MCP（模型上下文協定）伺服器——為 AI 代理提供資料庫、瀏覽器、API 存取權限——附帶冗長的工具定義，甚至在你使用任何功能之前，每台伺服器就會消耗 10,000+ 個 token 的上下文。連接幾台伺服器後，你就已經吃掉了一半的上下文視窗。

該適配器的巧妙之處在於：不是將所有伺服器的所有工具都載入到代理的上下文中，而是僅暴露 一個代理工具（約 200 個 token）。當代理真正需要特定功能時，它會呼叫代理，代理按需發現並呼叫正確的工具。伺服器是 懶加載 的——只有在呼叫其工具時才會連接。工具元資料會被快取，因此搜尋和描述操作無需即時連接即可完成。

安裝 僅需一條命令：pi install npm:pi-mcp-adapter。

設定 使用標準的 MCP 檔案（專案級用 .mcp.json，使用者全域用 ~/.config/mcp/mcp.json）以及 Pi 特有的覆蓋檔案。/mcp 面板負責設定，/mcp setup 可以將其他主機（Cursor、Claude Code、Codex）的設定匯入 Pi。該適配器還支援：

• 代理插件 — 從插件套件中載入 MCP 伺服器，使用 <plugin>__<server> 前綴
• Claude 插件 — 從本機插件目錄啟用 MCP 伺服器和技能（明確的信任邊界；從不下載或安裝插件）
• Pi 套件 — 將 MCP 伺服器打包進 Pi 套件中，無需單獨設定檔案
• 程式化使用 — createMcpAdapter({ config }) 用於 SDK 或伺服器整合，由其自行管理 MCP 設定
• OAuth — 共用 pi-mcp-adapter/oauth 模組，讓協作擴充功能重用 URL 綁定的 OAuth 權杖
• 事件總線 — 擴充功能可訂閱版本化通道，接收唯讀的伺服器狀態快照

安全細節：該適配器從不重寫外部主機檔案，從不靜默執行其中的命令，拒絕逃逸目錄的插件符號連結，並將 OAuth 流的密鑰（CSRF 狀態、PKCE 驗證器）保持在流內。停用伺服器僅在專案本地覆蓋檔案中寫入 disabled 標誌——原始檔案保持不變。

為何重要：它讓你無需支付上下文視窗成本即可存取 MCP 生態系統，讓代理按需發現工具，而非預先載入全部。