@fitchmultz/pi-mcp-adapter

中文文档
8.0.43发布于 2026/11/15MITTypeScriptES Module构建来源已验证近 30 天下载 9394

用于 Pi 编码代理机的切换高效 MCP 适配器

中文使用文档
文档目录7 节
  1. 安装
  2. 第一个用途
  3. 控制和设置
  4. 更多服务器特性
  5. 警告和平台限制
  6. 文档
  7. 许可证和背景

费奇 MCP 适配器

连接 Pi 用于浏览器、数据库和API的MCP服务器。 适配器在需要时会加载选定的工具计数,以使大型目录远离对话上下文.

Pi sends a task to the adapter. The adapter discovers tools, calls local or remote servers, and returns results with files for large text.

安装

检查 Pi和Node.js的要求。 。 。 .

pi install npm:@fitchmultz/pi-mcp-adapter
pi

如果安装时打开, 则重新启动 Pi 。 每Pi主机只装入一个适配器. " 遗产适配器状态 " 改为 " 升级指南 在您重新启动 Pi 之前.

对于 Git 安装, 运行 pi install git:github.com/fitchmultz/pi-mcp-adapter。 。 。 .

第一个用途

输入 /mcp setup 要添加服务器或从其他主机导入配置。 在保存前预览更改 。 适配器未更改外部主机文件.

适配器读取 .mcp.json 财务报告和审定财务报表 ~/.config/mcp/mcp.json 自动。 Pi 加载项目配置仅在项目信任后进行. 见 配置路径和优先级。 。 。 .

为 Chrome DevTools 创建 .mcp.json 在您的项目中 :

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

运行 /reload 配置更改后。 问皮:

使用 Chrome DevTools 来取取当前页面的截图 .

默认情况下,当 Pi 发现未标记目录或调用工具时,服务器会连接. 缓存目录注册为延迟的 Pi 工具, 没有连接: Pi's tool_search 装入任务需要的, codemode 脚本可以直接调用 mcp 网关发现还没有缓存目录的服务器 .

控制和设置

命令目的
/mcp显示服务器和 Pin 工具
/mcp status显示连接状态和工具/资源计数
/mcp reconnect <server>重新连接并刷新目录
/mcp-auth <server>在交互式会话中启动 OAuth
/mcp disable <server>禁用此工程的服务器; 应用 /reload
/mcp enable <server>启用此工程的服务器; 应用 /reload

使用 directTools 在启动时锁定工具。 其他工具将推迟到 tool_search 把它们装上 像Pi自己的MCP扩展,适配器激活已注册的 tool_search 当它注册被推迟的工具时, 一旦每次会话启动或树导航; 一个记录删除的分支 tool_search 让它关闭。 网关搜索覆盖已知目录; mcp({ action: "connect", server }) 发现未知目录.

使用 approveTools 在敏感通话前需要确认。 匹配呼叫在无头会话中失败, 未经批准 .

更多服务器特性

适配器支持 资源 财务报告和审定财务报表 提示模板。快速命令的使用 /mcp__<server>__<prompt> 名称.

MCP 应用程序 在浏览器中或通过打开交互式 UIS 闪烁 在macOS上。 Apps 可以发送消息给 Pi。 请尝试 交互式可视化器。 。 。 .

使用 Pi 键 codemode 用于工具 循环和依赖的工具调用。见 网关示例 确切的呼叫形状.

警告和平台限制

MCP服务器可以执行程序或访问账户. 在信任工程配置之前, 请检查服务器命令和账户访问 .

OAuth需要可用的OS证书存储. 在无头的Linux上解锁一个与特勤局兼容的密钥环. 适配器没有正文倒置. 见 OAuth 引导 远程登录.

Android和Termux默认不支持持久性的OAuth. 未经认证,头接, 和stdio服务器工作。 Git/ source 建築需要一款Android- native 相接器 tsgo 编译器. 如果没有编译器,则使用已预先编译的 npm 软件包。 见 Android 构建细节。 。 。 .

适配器将文本保存在默认的 50 KiB 或2,000行限制值之上到本地文件. 保存的结果和App历史可以包含敏感数据. 不再需要时删除文件 。 见 输出处理和回读。 。 。 .

如果 App 历史无法保存, 重新装入或退出会丢弃未保存的信件 。 在任一行动之前获取待处理信息。 见 App 历史和恢复。 。 。 .

文档

许可证和背景

米奇·富尔茨维持Fitch MCP 适应器 麻省理工学院许可证。Mario Zechner讨论工具计划成本 他关于MCP的文章。 。 。 .

监视适配器演示。 。 。 .

版本与发布记录

@fitchmultz/pi-mcp-adapter 共发布 49 个版本,首次发布于 2026/09/20;过去 12 个月发布了 49 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.0.43latest2026/11/15今天
8.0.422026/11/131 天前
8.0.412026/11/132 天前
8.0.402026/11/122 天前
8.0.392026/11/122 天前
8.0.382026/11/122 天前

关于 @fitchmultz/pi-mcp-adapter 的常见问题

@fitchmultz/pi-mcp-adapter 是什么?

用于 Pi 编码代理机的切换高效 MCP 适配器

如何安装 @fitchmultz/pi-mcp-adapter?

在项目目录运行 npm install @fitchmultz/pi-mcp-adapter,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fitch-mcp-adapter,可以用 npx fitch-mcp-adapter 直接运行。

@fitchmultz/pi-mcp-adapter 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fitchmultz/pi-mcp-adapter 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fitchmultz/pi-mcp-adapter 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^24.22.3 || >=26.13.1。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fitchmultz/pi-mcp-adapter 可以商用吗?

@fitchmultz/pi-mcp-adapter 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fitchmultz/pi-mcp-adapter 的下载量有多少?

根据 npm 官方下载统计,@fitchmultz/pi-mcp-adapter 在 2026/10/15 – 2026/11/13 这 30 天内被下载 9,394 次,日均约 313 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fitchmultz/pi-mcp-adapter 还在维护吗?

最新版本 8.0.43 发布于 2026/11/15(今天);至今共发布 49 个版本,其中过去 12 个月发布了 49 个;首次发布于 2026/09/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。