适合谁
- 使用 Pi 编码代理且希望降低 MCP 上下文开销的用户
- 需要访问多个 MCP 生态服务的开发者
- 希望使用延迟连接、元数据缓存或可选直接工具注册的用户
P
61FMRS · C
该项目是面向 Pi 的 MCP 适配扩展，不是独立业务型 MCP 服务器。其核心价值是通过单一代理工具、延迟启动和缓存元数据减少上下文消耗；实际能力、权限和风险取决于用户配置的 MCP 服务器。
Pi MCP Adapter 是一个 Pi 编码代理扩展，通过单个 mcp 代理工具按需发现和调用 MCP 工具。它默认延迟启动服务器，缓存工具元数据，并支持 stdio、Streamable HTTP 及 SSE 回退，从而减少上下文窗口占用。
工具能力
mcp
搜索、列出、描述、连接并调用已配置的 MCP 服务器工具，也支持查看服务器说明、UI 消息和处理 OAuth 流程。
安装接入
运行 pi install npm:pi-mcp-adapter，安装后重启 Pi。项目配置可写入 .mcp.json；用户级共享配置可写入 ~/.config/mcp/mcp.json。也可运行 pi-mcp-adapter init 扫描主机配置。
claude_desktop_config.json
{"mcpServers":{"chrome-devtools":{"command":"npx","args":["-y","chrome-devtools-mcp@latest"]}}}
选型与风险
不适合谁
- 不使用 Pi 的用户
- 需要跨 Pi 会话共享服务器进程的场景
- 需要 MCP sampling 传递上下文、工具、停止序列、音频或图像内容的场景
所需权限
- 读取和写入 Pi MCP 配置、工具元数据缓存及 OAuth 凭据目录
- 启动已配置的本地 MCP 进程并访问其工作目录
- 访问已配置的 HTTP MCP 端点、请求头、环境变量和 OAuth 凭据
- 根据所用 MCP 服务器实际需要访问文件、浏览器、数据库、API 或其他外部资源
风险与副作用
- 配置的 MCP 服务器可能获得其声明或实际使用所需的文件、网络、数据库或 API 权限
- OAuth 授权 URL、代码和令牌属于敏感凭据
- 超大文本结果可能被写入系统临时目录，且不会自动清理
- 跨主机会自动导入配置时，应检查导入内容及其权限范围
常见排障
- 安装后重启 Pi
- 检查 .mcp.json、~/.config/mcp/mcp.json、Pi 全局覆盖文件和 .pi/mcp.json 的优先级
- 运行 /mcp 查看服务器状态、工具和配置，必要时运行 /mcp reconnect <server>
- 若缺少标准配置，运行 /mcp setup 或 pi-mcp-adapter init
- 远程 OAuth 使用 auth-start 获取 URL，并用 auth-complete 提交完整重定向 URL或code
- 首次启用 directTools 时检查缓存；必要时运行 /mcp reconnect <server>
使用场景
在 Pi 中按需使用数据库、浏览器和 API 类 MCP 服务
通过搜索和描述功能发现 MCP 工具
为少量常用工具启用 directTools
在远程或无头环境中完成 OAuth 流程
支持客户端
Pi完整支持