Repolode
提交项目
nicobailon

nicobailon/pi-mcp-adapter

让 Pi 编程代理通过单一代理工具使用 MCP 服务器，避免工具定义占满上下文。

在 GitHub 查看
Star
1,642
Fork
393
未关闭 Issue
0
最近提交
24小时前

这是什么？

pi-mcp-adapter 把 Pi 编程代理接入 Model Context Protocol（MCP）服务器。它不会把所有工具定义塞进模型上下文，而是只暴露一个约 200 token 的代理工具，代理按需搜索并调用所需工具。

服务器默认惰性启动：首次调用时才连接，空闲 10 分钟后自动停止。适配器会读取 .mcp.json 等标准 MCP 配置文件，也能从 Cursor、Claude Code、Codex 和 VS Code 导入服务器配置。它支持 stdio、streamable HTTP、旧版 SSE 和 rmcp-mux 传输，OAuth 登录令牌存放在系统钥匙串中，并支持 MCP prompts、elicitation、sampling 和 Tasks。

这是一个通过 npm 安装的 TypeScript 扩展，面向 Pi 0.99 及以上版本，在 Pi 会话中替代其内置的 MCP 支持。

核心功能

  • 01只暴露一个代理工具，不把所有 MCP 工具定义加载进上下文
  • 02服务器惰性启动，空闲 10 分钟后自动停止
  • 03可从 Cursor、Claude Code、Codex 和 VS Code 导入服务器配置
  • 04支持 stdio、streamable HTTP、旧版 SSE 和 rmcp-mux 传输
  • 05OAuth 令牌存放在系统钥匙串中
  • 06可选配置 System One 密钥启用按语义搜索工具

适用场景

  • 在不占用过多上下文的前提下，让编程代理通过 MCP 访问数据库、浏览器或 API
  • 安装大量 MCP 服务器，但只为实际使用的服务器付出资源开销
  • 复用已在 Cursor 或 Claude Code 中配置好的 MCP 服务器

快速上手

  1. 1

    将适配器安装到 Pi 中

    pi install npm:pi-mcp-adapter
  2. 2

    安装后重启 Pi

  3. 3

    在项目的 .mcp.json 中添加服务器（参见 README 示例）

使用前须知

  • 它仅适用于 Pi 编程代理，不能作为独立的 MCP 客户端使用。
  • 语义工具搜索需要 System One 密钥；不使用密钥时仍可按词或正则搜索。

收录于专题

Claude Code 工具、技能与插件开源 AI Agent 框架与应用AI 编程助手与编码 AgentMCP Server 精选

标签

#mcp#ai-agent#coding-agent#llm#typescript#context-window#ai#claude#extension#model-context-protocol

常见问题

pi-mcp-adapter 是什么？
让 Pi 编程代理通过单一代理工具使用 MCP 服务器，避免工具定义占满上下文。 pi-mcp-adapter 把 Pi 编程代理接入 Model Context Protocol（MCP）服务器。它不会把所有工具定义塞进模型上下文，而是只暴露一个约 200 token 的代理工具，代理按需搜索并调用所需工具。
pi-mcp-adapter 可以免费使用吗？用的什么许可证？
pi-mcp-adapter 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
pi-mcp-adapter 还在维护吗？
活跃维护中。pi-mcp-adapter 最近一次提交是在 2026年11月6日。
pi-mcp-adapter 适合用来做什么？
在不占用过多上下文的前提下，让编程代理通过 MCP 访问数据库、浏览器或 API 安装大量 MCP 服务器，但只为实际使用的服务器付出资源开销 复用已在 Cursor 或 Claude Code 中配置好的 MCP 服务器
pi-mcp-adapter 怎么安装和运行？
将适配器安装到 Pi 中: pi install npm:pi-mcp-adapter 安装后重启 Pi 在项目的 .mcp.json 中添加服务器（参见 README 示例）
在哪里获取 pi-mcp-adapter？
源代码和安装说明在 GitHub 上：https://github.com/nicobailon/pi-mcp-adapter

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目