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。见 运行时安全和自定义信任。 。 。 .
使用 MCP 服务器 Pi 而不燃烧上下文窗口.
为什么这个存在
马里奥写道 为什么你可能不需要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多(测量(中文(简体) ) |
| 工具搜索 | 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个,以读取其工具列表. 计量和细节。 。 。 .
这个 完全比较 每一行都有来源,截至0.99.2.
当内置打开时,Pi可能会在启动时发出警告 /reload 它没有被装上。 适配器不修改 Pi 的用户或工程设置; 明确禁用内置 pi config 当两个扩展安装时。 若取出适配器,将内置回放(细节) (中文(简体) ).
安装
pi install npm:@diegopetrucci/[email protected]
TLH自动化应使用这个精确的被钉安装目标. 上游 v5.0.0 标签仅为收件主锚;叉拥有的软件包身份和版本为 @diegopetrucci/[email protected] 用于捆绑tlh整合. 5.2.0版本是一个仅分叉的次要发布(5.1.0加) 28号它的标签和公布证据尚未确定。 5.1.0版本是仅分叉的小型发布(5.0.2加 25号;其释放证据: 释放准备 公关#26 被挤压成 10c0d731ff60e39b50b07c6bf2b322dfe0013a05 25号船 附加说明标签 tlh-v5.1.0 对象 8304d47e405627bac23570096eaa492c7a90881e 目标,以及 GitHub 发布 最迟于5.1.0出版. @diegopetrucci/[email protected] 通过信任的 OIDC 发布 工作流程运行 42839376068 从2008年1月1日起 main 有输入 ref=tlh-v5.1.0因此,登记来源记录工作流程 refs/heads/main 承诺 10c0d73 (标记目标)而不是标记参考;Sigstore透明度日志索引是 3788141669npm 二边形 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号;其释放证据: 释放准备 公关#23 被挤压成 069f061a3623dd9699e5a7dc8f0169360ecc495f 还有22号船 附加说明标签 tlh-v5.0.2 对象 1e96356e9915fdb24ee2fe3f906959ca48116d80 目标,以及 GitHub 发布 最迟于5.0.2出版. @diegopetrucci/[email protected] 通过信任的 OIDC 发布 工作流程运行 39818321525 从2008年1月1日起 main 有输入 ref=tlh-v5.0.2因此,登记来源记录工作流程 refs/heads/main 承诺 069f061 (标记目标)而不是标记参考;Sigstore透明度日志索引是 3394249318npm 二边形 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号公关 被挤压成 f0d5d4efa884d1c6c84b301f8925beee94a54330 还有19号船 附加说明标签 tlh-v5.0.1 对象 9ec4f3c928fc7b898de762e4b0942a997b90b5d7 目标,以及 GitHub 发布 最迟于5.0.1出版. @diegopetrucci/[email protected] 通过信任的 OIDC 发布 工作流程运行 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 (英语) 合并时 a305e43e0abac015e6aeb988b15f1bba23f62e46,通过 OIDC工作流程运行 37613129066,并作为 tlh-v5.0.0。 。 。 .
维护者注释: 此分叉的上游摄入政策 docs/UPSTREAM-SYNC.md中,只有叉形三角洲跟踪 docs/tlh-patch-inventory.md。 。 。 .
安装后重新启动 Pi.
深西克·哈内斯(第三方桥): 通过 DSH 运行未修改的适配器 pi2dsh (英语); 见 已校验的 dsh- TUI 和 Web 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。 。 。 . |
| 主机特定配置( 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 在您的项目中 :
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "[email protected]"]
}
}
}
服务器是 默认懒惰 - 他们不会连接,直到你 真正打电话给他们的工具之一。 适配器缓存工具元数据如此搜索并描述没有活连接的工作.
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 | 配置 |
| 使用来自 Cursor、 Claude 代码或 Codex 的服务器 | /mcp-adapter setup 或者说 pi-mcp-adapter init | 导入已存在的配置 |
| 签名到 OAuth 服务器 | /mcp-auth <server> | 认证 |
| 将一些工具直接放入模型的工具列表 | "directTools": ["tool_a"] 在服务器上 | 直接工具 |
| 在危险工具运行前询问 | "approveTools": "destructive" | 工具核准 |
| 保持服务器运行 | "lifecycle": "keep-alive" | 生命周期模式 |
| 隐藏吵闹的工具 | includeTools 编号 : excludeTools 在服务器上 | 搜索激活的直接工具 |
| 连锁许多 MCP 呼叫一步 | settings.scriptMode: true,则 mcpScript | MCP 脚本 |
| 使用图像 | /mcp-adapter setup,添加相机(桌面) | 设置面板 |
图标
| 命令 | 它会做什么 |
|---|---|
/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 没有服务器,则仅在交互式用户界面中打开一个拾取器。 关于网关授权和手动回调完成,见 远程/无头认证。 。 。 .
在Pi 0.99和之后,您已经与Pi的内置MCP签约的服务器可以再使用该签名:适配器每服务器询问一次,以及 /mcp-adapter 提议 ctrl+p 以导入它们。 见 从 Pi 的内置 MCP 导入登录。 。 。 .
如何运作
- 一个
mcp工具在上下文(~200个令牌)中而不是数百个 - 服务器在默认情况下是懒惰的——它们连接在第一个工具呼叫上,而不是在启动时
- 工具元数据被缓存到磁盘中, 这样可以搜索/ 列表/ 描述没有活连接的工作
- 服务器在10分钟后断开( 可配置), 下次使用时自动连接
- 基于 npx 的服务器决心引导二进制路径, 跳过 ~143 MB npm 父进程
- MCP 服务器验证参数, 而不是适配器
- 在健康检查期间,在用户输入之前,以及在适配器触发转弯之前,远程保留服务器强制更新其工具目录,并有限定的再连接备份
- 特定工具可以通过代理工具被推广到一等Pi工具
directTools配置, 所以 LLM 直接看到它们 而不是需要搜索
限制
- 每个 Pi 会话运行自己的服务器进程; 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 整合) (中文(简体) ).
文档
全部参考文献存在于 docs/数字 :
| 医生 | 里面有什么东西 |
|---|---|
| 配置 | 设置面板、配置文件和优先级、从其他主机导入、项目服务器信任、生命周期模式以及每个 settings 键. |
| 服务器选项 | 每个服务器域,自定义HTTPS信任,macOS本地网络访问,协议谈判,MCP任务,stdio环境,和rmcp-mux. |
| 认证 | OAuth 设置,远程和无头的签入,信使存储,信使,无记名信使,以及秘密命令. |
| pi-mcp-adapter 对 Pi 的内置MCP | 每差一分,有出处,至于Pi 0.99.2. |
| 使用 MCP 工具 | 这个 mcp 工具、搜索和搜索关键词、直接工具、工具批准和输出保护. |
| MCP 脚本 | 这个 mcpScript 工具和可堆肥的工具搜索. |
| 提示、诱导和MCP UI | MCP作为斜线命令,服务器请求输入,以及交互式的MCP UI窗口来提示. |
| 扩展 API、插件和 SDK | 代理插件,克洛德插件捆绑,Pi套件清单,运行时间注册和工具呼叫, createMcpAdapter、主机管理的嵌入和状态活动. |