pi-mcp-adapter
活跃·★ 1.6k·MIT·更新于 2026-10-22
Pi MCP Adapter 让 Pi 编码智能体可以使用 MCP 服务，而不撑满上下文窗口。README 的出发点是：单个 MCP 服务就可能因为冗长的工具定义消耗一万多 token，并引用了一篇主张“可能根本不需要 MCP”的博客。适配器没有放弃 MCP 生态（数据库、浏览器、各种 API），而是只暴露一个约 200 token 的代理工具，让智能体按需搜索和发现工具：`mcp({ search: "screenshot" })` 查找工具，`mcp({ tool: "...", args: '{...}' })` 调用工具，README 拿它与 26 个工具塞满上下文的情况做了对比。
用 `pi install npm:pi-mcp-adapter` 安装，然后重启 Pi。它会自动读取标准的 MCP 文件（`~/.config/mcp/mcp.json`、`.mcp.json`，以及 Pi 专用的覆盖文件），并有明确的优先级顺序。服务默认是懒加载：只有调用工具时才连接，空闲超时（默认 10 分钟）后断开，并用缓存的元数据让搜索不依赖连接；另有 `eager` 和 `keep-alive` 模式，还可以用 `directTools` 把选定的工具直接暴露。README 也介绍了 MCP UI 集成。许可证为 MIT。
#人工智能#Claude#coding-agent#扩展插件#大语言模型#MCP 协议#MCP 服务器#模型上下文协议
01
功能特性
01单个代理工具（约200个令牌）取代数百个工具
02惰性服务器连接（首次使用时连接，空闲后断开）
03工具元数据缓存，无需实时连接即可搜索/列出/描述
04直接工具支持，将特定工具提升为 Pi 的一级工具
05通过 /mcp 命令提供交互式配置面板和引导式设置
02
为什么选择它
+用一个约 200 token 的代理工具，取代把每个服务的工具定义都放进上下文
+读取标准的 `.mcp.json` 和共享 MCP 配置文件，现有配置可直接使用
+懒加载连接，带空闲超时和缓存元数据；需要时也有 eager 和 keep-alive 模式
+`directTools` 选项可以把选定的工具直接暴露
03
权衡点
!只适用于 Pi 智能体，用于其他客户端没有意义
!调用工具要先搜索一步，而且 `args` 必须是 JSON 字符串，模型可能写错
!懒加载连接会让对每个服务的首次调用有启动延迟
!多个配置文件加优先级顺序，需要花些功夫理解
04
维护状况检查
活跃检查日期: 2026-10-18
- 最近提交
- 2026-10-18
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 30
- 最新发布
- v5.3.2 (2026-10-17)
- 未关闭 issue
- 0
- 近期 issue 至少有一条评论的比例
- 6/16
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
05
兼容性
cursor
Cursor
已通过文档验证
claude-code
Claude Code
已通过文档验证
claude-desktop
Claude Desktop
已通过文档验证
vscode
VS Code
已通过文档验证
windsurf
Windsurf
已通过文档验证
codex
Codex
已通过文档验证
06
快速开始
1
$ pi install npm:pi-mcp-adapter
07
使用场景
↳通过 MCP 数据库服务器访问数据库
↳使用浏览器自动化 MCP 服务器自动化浏览器任务
↳通过 MCP API 服务器集成外部 API
08
同类工具
⚡热门对决:
评论
登录后发表评论
暂无评论，来发表第一条吧