用途：为 Pi 编程智能体接入 Model Context Protocol（MCP）服务器，同时控制上下文占用。它不把每个服务器的数百个工具定义全部暴露给模型，而是提供一个约 200 token 的 mcp 代理工具，按需发现和调用 MCP 能力。
主要能力：单一代理工具替代大量工具定义；服务器懒加载，仅在调用工具时连接；可为高优先级工具启用直连注册；读取标准 MCP 配置文件（.mcp.json 与 ~/.config/mcp/mcp.json）；通过 /mcp 覆盖层交互式配置；支持 HTTP/SSE 服务器、OAuth、环境变量插值、资源读取、MCP UI 集成与子智能体集成。
安装与配置：执行 pi install npm:pi-mcp-adapter，安装后重启 Pi，适配器会在首次运行时自动检测标准 MCP 配置文件。配置优先级由低到高为 ~/.config/mcp/mcp.json、~/.pi/agent/mcp.json、.mcp.json、.pi/mcp.json。服务器可配置 command/args/env，或 url/headers；支持 auth: "oauth" 及 autoAuth 设置。
使用方式：默认通过 mcp 代理工具操作，如 mcp({ search: "query" }) 搜索工具、mcp({ list: true }) 列出工具、mcp({ describe: "tool" }) 查看参数、mcp({ tool: "name", args: "json" }) 执行工具，以及 action: "resources"、"read-resource"、"ui-messages" 等。可用 directTools 将指定工具直接注册给模型，用 excludeTools 排除工具。生命周期支持 lazy（默认）、eager、keep-alive，并可设置 idleTimeout。
适用场景：需要同时接入多个 MCP 服务器、又希望保持上下文窗口干净的 Pi 用户；需要按需加载、直连关键工具或管理 OAuth 服务器的项目。
限制：直连工具每个约增加 150-300 token，过多会占用上下文；disableProxyTool 仅在所需工具已直连并缓存后可用；samplingAutoApprove 为非 UI 会话所必需；具体收费、价格与效果资料未提供。