# @diegopetrucci/pi-mcp-adapter 中文文档

规范地址：https://npmcn.com/package/%40diegopetrucci/pi-mcp-adapter/

版本：5\.2\.0
npm 元数据更新时间：2026-11-10T16:46:44.675Z
中文译文更新时间：2026-11-12T07:40:34.550Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40diegopetrucci/pi-mcp-adapter
原文对照：https://npmcn.com/package/%40diegopetrucci/pi-mcp-adapter/?lang=original
项目主页：https://github.com/diegopetrucci/pi-mcp-adapter#readme
源码仓库：https://github.com/diegopetrucci/pi-mcp-adapter

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.7 MB，235 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^22\.23\.4 \|\| ^24\.22\.1 \|\| ^26\.12\.1
- 运行依赖：15 个
- peer 依赖：zod ^3\.25\.0 \|\| ^4\.0\.0，typebox \*，@earendil-works/pi-ai ^0\.84\.1 \|\| ^0\.85\.0 \|\| ^0\.86\.0 \|\| ^0\.87\.0 \|\| ^0\.99\.0 \|\| ^1\.0\.0，@earendil-works/pi-tui \*
- 首次发布：2026-06-29T22:54:50.823Z
- 最新版本发布：2026-11-10T16:46:44.307Z
- 近 30 天下载量：3683（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

MCP( 模式上下文协议) Pi 编码代理的适配器扩展

## 安装

```sh
npm install @diegopetrucci/pi-mcp-adapter
```

也可以使用：`pnpm add @diegopetrucci/pi-mcp-adapter`、`yarn add @diegopetrucci/pi-mcp-adapter`、`bun add @diegopetrucci/pi-mcp-adapter`

## README

![pi-mcp-adapter](https://npmcn.com/package/%40diegopetrucci/pi-mcp-adapter/banner.png)

# Pi MCP 磁共振 适配器

> TLH 分叉注释: 此分叉用于 **最后的尝试( tlh)**,其中tlh自动化捆绑并贴上相容性. 它无意作为TLH以外的一般独立分布目标.

需要节点.js **22.23.4+(22.x), 24.22.1+(24.x),或 26.12.1+(26.x)**,其他放行和预放行不支持. HTTP 传输、端点探测器、 OAuth 和提供者请求在旧运行时间失败, 即使 npm 忽略 `engines`。见 [运行时安全和自定义信任](https://npmcn.com/package/%40diegopetrucci/pi-mcp-adapter/docs/servers.md#runtime-security-and-custom-trust)。 。 。 .

使用 MCP 服务器 [Pi](https://github.com/badlogic/pi-mono/) 而不燃烧上下文窗口.

[https://github.com/user-attachments/assets/4b7c66ff-e27e-4639-b195-22c3db406a5a 互联网档案馆的存檔,存档日期2014-12-02](https://github.com/user-attachments/assets/4b7c66ff-e27e-4639-b195-22c3db406a5a)

## 为什么这个存在

马里奥写道 [为什么你可能不需要MCP](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/),问题:工具定义是动词. 一个单一的MCP服务器可以燃烧出10k+的令牌,而无论你是否使用这些工具,你都要付出这个代价. 连接几台服务器 在谈话开始前你已经烧了一半的上下文窗口.

他的拍摄:完全跳过MCP,改写简单的CLI工具.

但MCP生态系统有有用的东西——数据库,浏览器,API. 这个适配器可以让你无所事事 一个代理工具(~200个令牌)而不是上百个. 特工发现需要点播什么 服务器只在实际使用时才开始.

## pi-mcp-adapter 对 Pi 的内置MCP

此后,Pi 0.99增加了自己的MCP支持,这也使得工具定义脱离了上下文. 安装适配器在 Pi 会话中替换. 切换得到什么 :

-   **安装许多服务器而不支付闲置的服务器 .** 内置在每次 Pi 会话中启动每个启用的服务器,并一直运行到会话结束. 默认情况下,适配器会在模型首次调用时启动服务器,并在10分钟闲置后停止.
-   **日常通话的代号更少.** 默认情况下,内置内置将每个 MCP 调用作为 `codemode` 脚本,甚至单一找. 适配器的脚本默认关闭,所以一个搜索是 JSON 呼叫 `mcp` 工具,在测试中成本降低10-33%。 对于跨越许多记录的大量工作,请打开脚本 `settings.scriptMode`;然后费用与 `codemode`。 。 。 .
-   **更多服务器全面运作.** 服务器可以通过表单向您提问,显示交互式用户界面,并提供即时模板作为斜线命令. 内置的不处理这些.
-   **可预测的工具搜索 .** 适配器搜索工具名称和用词描述,并支持明确的正则表达式搜索.
-   **在您的OS 密钥链中签名** 默认(一个加密文件是选入的),而不是在 JSON 文件下 `~/.pi/agent`。 。 。 .
-   **添加服务器比较容易.** 添加定义到配置文件或使用中 `/mcp-adapter setup`,在修改文件前预览。 已经配置在 Cursor, Claude Code, Codex 或 VS 代码中的服务器可以通过设置导入,它也添加了Figma和GitHub等预设.

内置中有两个适配器没有的东西: 皮的许可扩展将每个MCP调用作为自己的工具调用,没有变化,它会向服务器发送根(会话目录). 皮丝 `codemode` 两者合作.

|  | Pi的内置MCP | pi- mcp- 适应器 |
| --- | --- | --- |
| 服务器运行 | 每个启用的服务器, 用于整个会话 | 只使用服务器;每台在闲用10分钟后停止 |
| 服务器内存( 100个安装中, 3个正在使用中) | 启动时7.0GB,15分钟后5.9GB | 只有3个在用,一旦闲了就没了 |
| 模型如何到达工具 | 默认 : `codemode` 剧本. 每个服务器:直接或装入 `tool_search` | 默认: 1 `mcp` 代理工具。 每个服务器:直接或装入 `tool_search`. 脚本: Pi's `codemode` (编) `"+codemode"` 改为 `defaultTools`)或适配器的 `mcpScript`,两个选入 |
| 托肯费用 | 默认情况下,每个呼叫都是 `codemode` 脚本 | 相较于内置的默认,单次取景成本会降低10-33%. 散装工作请打开 `scriptMode`;没有它,散装任务的费用最多可达7x多([测量](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/pi-builtin-comparison.md#measured-token-cost)(中文(简体) ) |
| 工具搜索 | `tool_search`,按单词排序 | `mcp({ search })` 按单词或正则排列. |
| 证书 | JSON 文件输入 `~/.pi/agent` | OS 键链 |
| MCP 提示、诱导、取样、任务 | 没有 | 是; 任务需要 `"protocolVersion": "auto"` |
| MCP UI 应用程序 | 离开 | 默认关闭, 如 Claude 代码和 Codex CLI; 选择使用 `MCP_UI_VIEWER` 用于本地窗口或浏览器 |
| 添加服务器 | `pi mcp add` 在壳里,然后 `/reload` | 添加到配置文件, 或使用 `/mcp-adapter setup` |
| 来自 Cursor、 Claude 代码、 Codex、 VS 代码的配置 | 手工转换 | 已导入 |
| 在会话中指导设置 | 没有; `/mcp` 管理已配置的服务器 | `/mcp-adapter setup` 覆盖:导入您机器上的配置, 在安装时添加预设( Figma 桌面和 RepoPrompt, GitHub, Notion, 背景7, DeepWiki, 并行搜索, Chrome DevTools) , 在写入前预览每个文件更改 |
| 在危险工具前询问 | 通过权限扩展, 它可以看到每个 MCP 呼叫 | 内建(`approveTools`; 权限扩展将代理调用视为代理工具 |
| 根 (发送到服务器的会议目录) | 对 | 没有 |
| 贝壳命令 | `pi mcp add`, (中文(简体) ), `remove`, (中文(简体) ), `list` | `pi-mcp-adapter init`, (中文(简体) ), `doctor` |
| 运输 | stdio, 可流式 HTTP | stdio,可流回式HTTP,遗产SSE, `rmcp-mux` 套接字 |

用100个小型本地服务器测量的会话:

| 安装100台服务器,使用了3台 | Pi的内置MCP | pi- mcp- 适应器 |
| --- | --- | --- |
| 在会话开始时运行的服务器 | 100个 | 0 个 |
| 你用三块 | 100个 | 3个 |
| 闲暇超时后( 10分钟) | 100个 | 0 个 |

停止服务器不会带走其工具:模型仍然可以搜索它们,一个被停止的服务器在下一次呼叫(0.1–0.3 s为小型本地服务器)时再次启动. 对于一个必须在呼叫间保持状态的服务器, 设置 `"lifecycle": "lazy-keep-alive"`。第一个会话简短地启动新的服务器,每次10个,以读取其工具列表. [计量和细节](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/pi-builtin-comparison.md#measured-with-100-servers)。 。 。 .

这个 [完全比较](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/pi-builtin-comparison.md) 每一行都有来源,截至0.99.2.

当内置打开时,Pi可能会在启动时发出警告 `/reload` 它没有被装上。 适配器不修改 Pi 的用户或工程设置; 明确禁用内置 `pi config` 当两个扩展安装时。 若取出适配器,将内置回放([细节](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/configuration.md#pis-built-in-mcp)) (中文(简体) ).

## 安装

```bash
pi install npm:@diegopetrucci/pi-mcp-adapter@5.2.0
```

TLH自动化应使用这个精确的被钉安装目标. 上游 `v5.0.0` 标签仅为收件主锚;叉拥有的软件包身份和版本为 `@diegopetrucci/pi-mcp-adapter@5.2.0` 用于捆绑tlh整合. 5.2.0版本是一个仅分叉的次要发布(5.1.0加) [28号](https://github.com/diegopetrucci/pi-mcp-adapter/pull/28)它的标签和公布证据尚未确定。 5.1.0版本是仅分叉的小型发布(5.0.2加 [25号](https://github.com/diegopetrucci/pi-mcp-adapter/pull/25);其释放证据: 释放准备 [公关#26](https://github.com/diegopetrucci/pi-mcp-adapter/pull/26) 被挤压成 [`10c0d731ff60e39b50b07c6bf2b322dfe0013a05`](https://github.com/diegopetrucci/pi-mcp-adapter/commit/10c0d731ff60e39b50b07c6bf2b322dfe0013a05) 25号船 附加说明标签 `tlh-v5.1.0` 对象 `8304d47e405627bac23570096eaa492c7a90881e` 目标,以及 [GitHub 发布](https://github.com/diegopetrucci/pi-mcp-adapter/releases/tag/tlh-v5.1.0) 最迟于5.1.0出版. `@diegopetrucci/pi-mcp-adapter@5.1.0` 通过信任的 OIDC 发布 [工作流程运行 42839376068](https://github.com/diegopetrucci/pi-mcp-adapter/actions/runs/42839376068) 从2008年1月1日起 `main` 有输入 `ref=tlh-v5.1.0`因此,登记来源记录工作流程 `refs/heads/main` 承诺 `10c0d73` (标记目标)而不是标记参考;Sigstore透明度日志索引是 `3788141669`npm 二边形 `latest` 曾经 `5.1.0` ; 软件包有235个文件, 完整性 `sha512-VDjhbUaQTLRtTgNtQOQ8VKj2GnP5nyA4OMTi8nQH25Fm0eODu+p73paHxFFdPPbKINj4V3XqQIOyGOiGpB/LJQ==`和发动机 `^22.23.4 || ^24.22.1 || ^26.12.1`; 头是 `10c0d73`,而登记册出处有效载荷主体的文摘与完整性相符。 独立加密签名核查、现场提供商E2E和新审计不主张。 5.0.2版本是纯叉补丁(5.0.1加) [22号](https://github.com/diegopetrucci/pi-mcp-adapter/pull/22);其释放证据: 释放准备 [公关#23](https://github.com/diegopetrucci/pi-mcp-adapter/pull/23) 被挤压成 [`069f061a3623dd9699e5a7dc8f0169360ecc495f`](https://github.com/diegopetrucci/pi-mcp-adapter/commit/069f061a3623dd9699e5a7dc8f0169360ecc495f) 还有22号船 附加说明标签 `tlh-v5.0.2` 对象 `1e96356e9915fdb24ee2fe3f906959ca48116d80` 目标,以及 [GitHub 发布](https://github.com/diegopetrucci/pi-mcp-adapter/releases/tag/tlh-v5.0.2) 最迟于5.0.2出版. `@diegopetrucci/pi-mcp-adapter@5.0.2` 通过信任的 OIDC 发布 [工作流程运行 39818321525](https://github.com/diegopetrucci/pi-mcp-adapter/actions/runs/39818321525) 从2008年1月1日起 `main` 有输入 `ref=tlh-v5.0.2`因此,登记来源记录工作流程 `refs/heads/main` 承诺 `069f061` (标记目标)而不是标记参考;Sigstore透明度日志索引是 `3394249318`npm 二边形 `latest` 曾经 `5.0.2` ; 软件包有231个文件, 完整性 `sha512-Z+S4grugsBND4g216tOMvpAcOBp0fpD8mt40pvWvM5DUqiFMoUFWtJWoFvzKCfQL7UueF+eCuLWnwsD6ahBUuA==`和发动机 `^22.23.4 || ^24.22.1 || ^26.12.1`; 头是 `069f061`,而登记册出处有效载荷主体的文摘与完整性相符。 独立加密签名核查、现场提供商E2E和新审计不主张。 5.0.1版本是上游v5.0.0摄入量上方的纯叉补丁; 发行-准备 [20号公关](https://github.com/diegopetrucci/pi-mcp-adapter/pull/20) 被挤压成 [`f0d5d4efa884d1c6c84b301f8925beee94a54330`](https://github.com/diegopetrucci/pi-mcp-adapter/commit/f0d5d4efa884d1c6c84b301f8925beee94a54330) 还有19号船 附加说明标签 `tlh-v5.0.1` 对象 `9ec4f3c928fc7b898de762e4b0942a997b90b5d7` 目标,以及 [GitHub 发布](https://github.com/diegopetrucci/pi-mcp-adapter/releases/tag/tlh-v5.0.1) 最迟于5.0.1出版. `@diegopetrucci/pi-mcp-adapter@5.0.1` 通过信任的 OIDC 发布 [工作流程运行 39778515390](https://github.com/diegopetrucci/pi-mcp-adapter/actions/runs/39778515390) 从2008年1月1日起 `main` 有输入 `ref=tlh-v5.0.1`因此,登记来源记录工作流程 `refs/heads/main` 承诺 `f0d5d4e` (标记目标)而不是标记参考. npm 二边形 `latest` 曾经 `5.0.1` ; 软件包有 230 文件, 完整性 `sha512-yN1cFPst5nbgm88WxZ+s8AlKcEwJvoC9RshK/6tgQxBjdckTSglS/DASa3k3xLMyB/W8qUG1Fkz0LNGFnC2rbw==`和发动机 `^22.23.4 || ^24.22.1 || ^26.12.1`; 登记册出处有效载荷主体汇编与完整性相符。 独立加密签名核查、现场提供商E2E和新审计不主张。 V5.0.0 摄入释放通过 [PR # 17 (英语)](https://github.com/diegopetrucci/pi-mcp-adapter/pull/17) 合并时 [`a305e43e0abac015e6aeb988b15f1bba23f62e46`](https://github.com/diegopetrucci/pi-mcp-adapter/commit/a305e43e0abac015e6aeb988b15f1bba23f62e46),通过 [OIDC工作流程运行 37613129066](https://github.com/diegopetrucci/pi-mcp-adapter/actions/runs/37613129066),并作为 [`tlh-v5.0.0`](https://github.com/diegopetrucci/pi-mcp-adapter/releases/tag/tlh-v5.0.0)。 。 。 .

维护者注释: 此分叉的上游摄入政策 `docs/UPSTREAM-SYNC.md`中,只有叉形三角洲跟踪 `docs/tlh-patch-inventory.md`。 。 。 .

安装后重新启动 Pi.

> **深西克·哈内斯(第三方桥):** 通过 DSH 运行未修改的适配器 [pi2dsh (英语)](https://github.com/weijiafu14/pi2dsh); 见 [已校验的 dsh- TUI 和 Web MCP 指南](https://github.com/weijiafu14/pi2dsh/tree/main/examples/tui-mcp)。 。 。 .

## 初赛时会发生什么

适配器自动读取标准MCP文件. 不需要额外的设置 如果你已经有了它们.

| 你已经... | 发生什么事 |
| --- | --- |
| `.mcp.json` 或者说 `~/.config/mcp/mcp.json` | 皮马上使用. 使用 `.mcp.json` 项目/团队共享和 `~/.config/mcp/mcp.json` 所有项目. |
| 服务器添加到 `pi mcp add` (单位:千美元)`~/.pi/agent/mcp.json`, (中文(简体) ), `.pi/mcp.json`(中文(简体) ) | 在Pi 0.99上及后期,适配器使用它们并取代了Pi的内置的MCP扩展,由Pi在启动时报告;参见: [Pi的内置MCP](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/configuration.md#pis-built-in-mcp)。 。 。 . |
| 主机特定配置( Cursor, Claude Code, Codex等) , 但没有标准 MCP 文件 | 运行 `/mcp-adapter setup` 将那些主机配置输入到 Pi。 设置流程显示它所找到的,让你选择要导入的,并在写入前预览确切的文件更改. |
| 还没有配置 | 运行 `/mcp-adapter setup`,选择工程 `.mcp.json` 或全球 `~/.config/mcp/mcp.json`,然后脚手架设置一个最小的配置,添加一个被整理的已知服务器,快速添加RepoPrompt,或者检查适配器在您机器上发现的东西. |

如果你喜欢终端,你也可以运行 `pi-mcp-adapter init` 安装后扫描特定主机配置, 并将缺失的相容性导入添加到适配器配置中 ()`~/.pi/agent/mcp-adapter.json` 默认,或 `$PI_CODING_AGENT_DIR/mcp-adapter.json` (设定时).

## 快速启动

添加服务器到 `.mcp.json` 在您的项目中 :

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

服务器是 **默认懒惰** - 他们不会连接,直到你 真正打电话给他们的工具之一。 适配器缓存工具元数据如此搜索并描述没有活连接的工作.

```
mcp({ search: "screenshot" })
```

```
chrome_devtools_take_screenshot
  Take a screenshot of the page or element.

  Parameters:
    format (enum: "png", "jpeg", "webp") [default: "png"]
    fullPage (boolean) - Full page instead of viewport
```

```
mcp({ tool: "chrome_devtools_take_screenshot", args: { format: "png" } })
```

两通电话 而不是26个工具 搅乱了上下文.

## 共同任务

| 想要吗 | 执行 | 细节 |
| --- | --- | --- |
| 不编辑 JSON 添加服务器 | `/mcp-adapter setup` | [配置](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/configuration.md#setup-panel) |
| 使用来自 Cursor、 Claude 代码或 Codex 的服务器 | `/mcp-adapter setup` 或者说 `pi-mcp-adapter init` | [导入已存在的配置](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/configuration.md#import-existing-configs) |
| 签名到 OAuth 服务器 | `/mcp-auth <server>` | [认证](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/auth.md) |
| 将一些工具直接放入模型的工具列表 | `"directTools": ["tool_a"]` 在服务器上 | [直接工具](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/tools.md#direct-tools) |
| 在危险工具运行前询问 | `"approveTools": "destructive"` | [工具核准](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/tools.md#tool-approval) |
| 保持服务器运行 | `"lifecycle": "keep-alive"` | [生命周期模式](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/configuration.md#lifecycle-modes) |
| 隐藏吵闹的工具 | `includeTools` 编号 : `excludeTools` 在服务器上 | [搜索激活的直接工具](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/tools.md#search-activated-direct-tools) |
| 连锁许多 MCP 呼叫一步 | `settings.scriptMode: true`,则 `mcpScript` | [MCP 脚本](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/scripting.md) |
| 使用图像 | `/mcp-adapter setup`,添加相机(桌面) | [设置面板](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/configuration.md#setup-panel) |

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `/mcp-adapter` | 互动面板和首发登入面板 |
| `/mcp` | 与 `/mcp-adapter` |
| `/mcp-adapter setup` | 进口指导设置,最低 `.mcp.json`、管理已知服务器、快速添加和配置路径检查 |
| `/mcp-adapter edit [project|global]` | 打开 `.mcp.json` (违约)或 `~/.config/mcp/mcp.json` 在编辑器中; Ctrl+G 打开 `$EDITOR`; 保存有效的 JSONC 对象并重新装入 |
| `/mcp-adapter tools` | 列出所有工具 |
| `/mcp-adapter prompts` | 列出所有登记为斜线命令的 MCP 提示 |
| `/mcp-adapter reconnect` | 重新连接所有服务器 |
| `/mcp-adapter reconnect <server>` | 连接或重新连接单个服务器 |
| `/mcp-adapter disable <server>` | 在本地工程中禁用服务器 `.pi/mcp-adapter.json` (所需经费) `/reload` (将适用) |
| `/mcp-adapter enable <server>` | 通过工程本地覆盖层启用( 需要) `/reload` (将适用) |
| `/mcp-adapter logout <server>` | 清除存储的服务器 OAuth 证书并断开它 |
| `/mcp-auth` | 在交互式用户界面会话中打开 OAuth 服务器拾取器 |
| `/mcp-auth <server>` | 特定服务器的 OAuth 设置 |

若为 `settings.autoAuth` 实值 `true`, (中文(简体) ), `mcp({ connect: ... })`, (中文(简体) ), `mcp({ tool: ... })`,直接工具调用在需要时自动运行 OAuth 并重试一次 .

在交互式会话中,您也可以从 `/mcp-adapter` 与 `ctrl+a` 或输入需要认证的服务器. `/mcp-auth` 没有服务器,则仅在交互式用户界面中打开一个拾取器。 关于网关授权和手动回调完成,见 [远程/无头认证](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/auth.md#remoteheadless-authentication)。 。 。 .

在Pi 0.99和之后,您已经与Pi的内置MCP签约的服务器可以再使用该签名:适配器每服务器询问一次,以及 `/mcp-adapter` 提议 `ctrl+p` 以导入它们。 见 [从 Pi 的内置 MCP 导入登录](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/auth.md#import-a-sign-in-from-pis-built-in-mcp)。 。 。 .

## 如何运作

-   一个 `mcp` 工具在上下文(~200个令牌)中而不是数百个
-   服务器在默认情况下是懒惰的——它们连接在第一个工具呼叫上,而不是在启动时
-   工具元数据被缓存到磁盘中, 这样可以搜索/ 列表/ 描述没有活连接的工作
-   服务器在10分钟后断开( 可配置), 下次使用时自动连接
-   基于 npx 的服务器决心引导二进制路径, 跳过 ~143 MB npm 父进程
-   MCP 服务器验证参数, 而不是适配器
-   在健康检查期间,在用户输入之前,以及在适配器触发转弯之前,远程保留服务器强制更新其工具目录,并有限定的再连接备份
-   特定工具可以通过代理工具被推广到一等Pi工具 `directTools` 配置, 所以 LLM 直接看到它们 而不是需要搜索

## 限制

-   每个 Pi 会话运行自己的服务器进程; [rmcp- mux (英语)](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/servers.md#shared-mcp-processes-with-rmcp-mux) 可以分享一个跨会
-   压缩 MCP 结果渲染总结出文本,但内置图像仍然被Pi的图像显示设置所控制,并可能渲染出紧凑文本摘要下方.
-   Pi在自发工具输出前仍然拥有一行分隔符,因此紧凑模式会降低适配器的渲染高度,但无法保证真正的零差距行.
-   MCP采样支持只使用文本;上下文包含,工具,停止序列,音频,和图像内容被明确错误地拒绝.
-   MCP UI apps 默认关闭:适配器不广告 `io.modelcontextprotocol/ui` 能力及 `ui://` 工具返回普通内线结果。 设定 `MCP_UI_VIEWER` 改为 `auto` (以前为缺省), `browser`, (中文(简体) ), `glimpse`,或 `orca` 打开工具 UI; `none`, (中文(简体) ), `off`, (中文(简体) ), `disabled`,且未知值保持用户界面([MCP UI 整合](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/prompts-and-ui.md#mcp-ui-integration)) (中文(简体) ).

## 文档

全部参考文献存在于 `docs/`数字 :

| 医生 | 里面有什么东西 |
| --- | --- |
| [配置](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/configuration.md) | 设置面板、配置文件和优先级、从其他主机导入、项目服务器信任、生命周期模式以及每个 `settings` 键. |
| [服务器选项](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/servers.md) | 每个服务器域,自定义HTTPS信任,macOS本地网络访问,协议谈判,MCP任务,stdio环境,和rmcp-mux. |
| [认证](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/auth.md) | OAuth 设置,远程和无头的签入,信使存储,信使,无记名信使,以及秘密命令. |
| [pi-mcp-adapter 对 Pi 的内置MCP](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/pi-builtin-comparison.md) | 每差一分,有出处,至于Pi 0.99.2. |
| [使用 MCP 工具](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/tools.md) | 这个 `mcp` 工具、搜索和搜索关键词、直接工具、工具批准和输出保护. |
| [MCP 脚本](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/scripting.md) | 这个 `mcpScript` 工具和可堆肥的工具搜索. |
| [提示、诱导和MCP UI](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/prompts-and-ui.md) | MCP作为斜线命令,服务器请求输入,以及交互式的MCP UI窗口来提示. |
| [扩展 API、插件和 SDK](https://github.com/nicobailon/pi-mcp-adapter/blob/main/docs/extension-api.md) | 代理插件,克洛德插件捆绑,Pi套件清单,运行时间注册和工具呼叫, `createMcpAdapter`、主机管理的嵌入和状态活动. |

## 常见问题

### @diegopetrucci/pi-mcp-adapter 是什么？

MCP\( 模式上下文协议\) Pi 编码代理的适配器扩展

### 如何安装 @diegopetrucci/pi-mcp-adapter？

在项目目录运行 npm install @diegopetrucci/pi-mcp-adapter，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^3\.25\.0 \|\| ^4\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 pi-mcp-adapter，可以用 npx pi-mcp-adapter 直接运行。

### @diegopetrucci/pi-mcp-adapter 支持 TypeScript 吗？

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

### @diegopetrucci/pi-mcp-adapter 支持 ESM 还是 CommonJS？

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

### @diegopetrucci/pi-mcp-adapter 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js ^22\.23\.4 \|\| ^24\.22\.1 \|\| ^26\.12\.1。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @diegopetrucci/pi-mcp-adapter 可以商用吗？

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

### @diegopetrucci/pi-mcp-adapter 的下载量有多少？

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

### @diegopetrucci/pi-mcp-adapter 还在维护吗？

最新版本 5\.2\.0 发布于 2026/11/11（1 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/06/30。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。