$ cat ~/map/pi-mcp-adapter.md

Pi MCP Adapter

在 Pi 中使用 MCP 服务器，同时避免耗尽上下文窗口。

extensions✓ 10月16日

事实速查

安装

pi install npm:pi-mcp-adapter

## 速览

在 pi 中使用 MCP 服务器而不烧掉上下文窗口：用一个约 200 token 的代理工具替代成百上千条冗长的工具定义，服务器只在真正使用时启动，agent 按需发现能力。

$解决 MCP 的 token 税——单个 MCP 服务器的工具定义就可能吃掉 10k+ token；适配器只暴露一个代理工具，真正调用时才拉取工具 schema。
$已有 MCP 配置零配置启动：自动检测 .mcp.json 与 ~/.config/mcp/mcp.json；/mcp setup 可导入 Cursor、Claude Code、Codex 的宿主配置，写入前预览每一处文件变更。
$支持每服务器生命周期模式、工具审批（tool approval）、输出防护（output guard）、远程/无头 OAuth、经 rmcp-mux 共享 MCP 进程、MCP 脚本化、prompts 与 elicitation。
$也可作为 agent 插件嵌入或由其他扩展运行时注册；命令行 pi-mcp-adapter init 会扫描宿主配置并把兼容导入写入 pi agent 目录。

Q 安装后要重启 pi 吗？

要——pi install npm:pi-mcp-adapter 后重启 Pi，之后用 /mcp 命令完成配置、状态查看与每服务器选项。

Q 什么都没配置时首次运行会怎样？

/mcp setup 会生成最小 .mcp.json 骨架、提供精选已知服务器、快捷添加 RepoPrompt，或只展示适配器在你机器上发现了什么。

Q 能在 DeepSeek Harness 里跑吗？

能——第三方 pi2dsh 桥接项目可在 DSH 下运行未经修改的本适配器，其 examples 里有一份经过验证的 TUI/Web MCP 指南。