← 返回目录

Pi MCP Adapter

社区

网关 / 代理

为 Pi 提供低上下文开销的 MCP 访问。

这是聚合或代理其他 MCP Server 的网关，需要再接入具体的 Server 才有实际能力。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 108 / 438
Stars: ★ 1.6k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP · SSE
运行环境: Node.js
凭据: 可选 API Key
许可证: MIT
最近提交: 9 天前
工具数: 1

61FMRS · C

该项目是面向 Pi 的 MCP 适配扩展，不是独立业务型 MCP 服务器。其核心价值是通过单一代理工具、延迟启动和缓存元数据减少上下文消耗；实际能力、权限和风险取决于用户配置的 MCP 服务器。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

10/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README 描述了懒加载、缓存、超时、重连、输出保护和 OAuth 流程，说明正常路径是可行的；但服务器清单未缓存，且提示材料没有源代码、CI 或提交测试来验证 MCP 初始化、工具列表握手、参数行为和失败处理。因此按静态审查扣分，不能超过 12 分。
安全与权限 12/20: 文档披露了 bearer/OAuth 凭据、环境变量、远程授权码和外部 HTTP/stdio 服务器的数据边界；OAuth URL/code 被明确标记为敏感，临时输出文件使用 0600，URL UI 需要用户同意，且提供工具排除和超大输出保护。这些是正面证据；但配置允许任意命令、工作目录、环境变量、远程端点和 MCP 工具副作用，未提供源代码级沙箱、权限隔离、审计或危险操作确认的完整证据，因此扣分。
维护活跃度 10/20: 项目标记为未归档并声明 MIT 许可证，说明基本可维护性和再发布条件清晰；但仅有星数和开放 issue 数，缺少版本发布、提交频率、依赖更新、安全响应渠道、维护者治理或 CI 证据。流行度不计分，因此仅给中等分数。
文档质量 16/20: README 覆盖安装、配置优先级、stdio/HTTP、OAuth、生命周期、直接工具、UI、输出大小限制、命令、示例和已知限制，信息层次和可操作性较强；但没有源文件或验证结果支持这些声明，且缺少经过证实的兼容性、测试覆盖、故障诊断细节和安全审计说明，因此未给满分。
安装易用性 13/20: 提供单步 npm 安装、标准配置示例、共享配置路径、首次运行引导、主机配置导入、交互式面板以及远程 OAuth 流程，主流 Pi 场景的步骤较清楚；但仍依赖 Pi、Node/npm、外部 MCP 服务器和本地配置环境，平台兼容性与实际成功连接没有源代码、CI 或测试证据，故扣分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码访问网络控制浏览器

适合谁

使用 Pi 编码代理且希望降低 MCP 上下文开销的用户
需要访问多个 MCP 生态服务的开发者
希望使用延迟连接、元数据缓存或可选直接工具注册的用户

不适合谁

不使用 Pi 的用户
需要跨 Pi 会话共享服务器进程的场景
需要 MCP sampling 传递上下文、工具、停止序列、音频或图像内容的场景

所需权限

读取和写入 Pi MCP 配置、工具元数据缓存及 OAuth 凭据目录
启动已配置的本地 MCP 进程并访问其工作目录
访问已配置的 HTTP MCP 端点、请求头、环境变量和 OAuth 凭据
根据所用 MCP 服务器实际需要访问文件、浏览器、数据库、API 或其他外部资源

风险与副作用

配置的 MCP 服务器可能获得其声明或实际使用所需的文件、网络、数据库或 API 权限
OAuth 授权 URL、代码和令牌属于敏感凭据
超大文本结果可能被写入系统临时目录，且不会自动清理
跨主机会自动导入配置时，应检查导入内容及其权限范围

安装接入

准备工作

运行环境：Node.js

其他可选配置项（4 个）

MCP_OAUTH_DIR 可选旧版明文 tokens. 的导入目录，仅用于迁移旧凭据，非凭据命名空间。

MCP_OUTPUT_GUARD 可选设为 0 可关闭超大 MCP 输出的截断保护。

MCP_UI_VIEWER 可选控制 MCP UI 渲染方式：browser、glimpse 或 none。

PI_CODING_AGENT_DIR 可选覆盖 Pi agent 目录（默认 ~/.pi），影响 mcp. 与缓存路径。

运行 pi install npm:pi-mcp-adapter，安装后重启 Pi。项目配置可写入 .mcp.json；用户级共享配置可写入 ~/.config/mcp/mcp.json。也可运行 pi-mcp-adapter init 扫描主机配置。

MCP 配置 · JSON

{"mcpServers":{"chrome-devtools":{"command":"npx","args":["-y","chrome-devtools-mcp@latest"]}}}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后重启 Pi，打开 /mcp 面板确认适配器已加载；再调用 mcp({ search: "screenshot" })，能返回 chrome_devtools_take_screenshot 等工具说明连接成功。

常见排障

安装后重启 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>

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 mcp 搜索并调用 chrome-devtools 的 take_screenshot 工具，截取当前页面
运行 mcp({}) 查看当前有哪些 MCP 服务器已连接
用 mcp({ search: "screenshot" }) 查找与截图相关的工具
对 linear-server 执行 mcp({ action: "auth-start", server: "linear-server" }) 开始 OAuth 登录

工具能力 1

mcp 写入

搜索、列出、描述、连接并调用已配置的 MCP 服务器工具，也支持查看服务器说明、UI 消息和处理 OAuth 流程。

使用场景

在 Pi 中按需使用数据库、浏览器和 API 类 MCP 服务

通过搜索和描述功能发现 MCP 工具

为少量常用工具启用 directTools

在远程或无头环境中完成 OAuth 流程

支持客户端

依据项目文档列出，未经本站实测。

详细介绍

Pi MCP Adapter 是一个 Pi 编码代理扩展，通过单个 mcp 代理工具按需发现和调用 MCP 工具。它默认延迟启动服务器，缓存工具元数据，并支持 stdio、Streamable HTTP 及 SSE 回退，从而减少上下文窗口占用。