pi-mcp-adapter进阶:rmcp-mux让多个Pi会话共享同一个MCP进程,省资源指南
pi-mcp-adapter进阶:rmcp-mux让多个Pi会话共享同一个MCP进程,省资源指南
pi-mcp-adapter 是一个为 Pi 编码代理(Pi coding agent)提供 Token 高效 MCP 接入的适配器。本文讲解进阶用法:如何用 rmcp-mux 让多个 Pi 会话共享同一个 MCP 进程,避免每个会话各起一份服务器、白白浪费内存和 CPU。
为什么多开会话会浪费资源?
pi-mcp-adapter 的核心设计是惰性(lazy)生命周期:MCP 服务器默认不在会话启动时连接,而是模型第一次调用工具时才启动;空闲 10 分钟(idleTimeout 默认值)后自动断开。这已经比"每个会话把所有服务器全拉起来"的做法省很多资源——官方对比文档 pi-builtin-comparison.md 里用 100 个服务器实测过。
但注意一个边界:每个 Pi 会话仍然运行自己的一份服务器进程。也就是说:
- 你同时开着 3 个 Pi 会话,都用到同一个 stdio MCP 服务器 → 系统里就有 3 个服务器进程;
- 会话 A 空闲 10 分钟后断开的是它自己的连接,并不会影响也不会复用会话 B 的进程。
对于启动慢、占内存重的服务器(比如需要加载大模型、连接重型后端的 stdio 服务),多开几份就是实打实的浪费。
rmcp-mux:让多个会话共用一个上游进程
解决办法是 docs/servers.md 中介绍的 rmcp-mux 传输方式:把 MCP 服务器跑在 rmcp-mux 服务之下,各 Pi 会话不再各自 command 拉起进程,而是通过 Unix 域套接字(socket)连到同一个共享服务。
架构变化一句话概括:
| 方式 | 3 个会话使用同一服务器 | 空闲断开后 |
|---|---|---|
普通 command 启动 |
3 份独立进程 | 各自进程被停 |
经 rmcp-mux 的 socket 连接 |
1 份共享进程 | 仅关闭本会话的客户端连接,上游进程继续存活 |
配置方法:把 command 换成 socket
在 .mcp.json 中,把原来 command 形式的服务器条目改为 socket 字段,指向 rmcp-mux 的套接字文件。官方示例见 servers.md 第 113-127 行:
{
"mcpServers": {
"memory": {
"socket": "~/.rmcp-servers/rmcp-mux/sockets/memory.sock"
}
}
}
几个要点:
socket字段与command、url互斥,一个服务器条目三选一,参见 servers.md 字段表;- 路径支持
~、${VAR}、$env:VAR展开; - rmcp-mux 守护进程需要单独启动和配置——pi-mcp-adapter 只负责连上去,它不会去发现、启动或停止 rmcp-mux 的守护进程。
职责边界:adapter 管什么,rmcp-mux 管什么
这是理解整个机制的关键(同样来自 docs/servers.md):
- pi-mcp-adapter:只拥有自己的那条客户端 socket,Pi 运行时停止时关闭该连接。仅此而已。
- rmcp-mux:拥有上游 MCP 进程本体,负责请求路由、初始化缓存、重启策略、客户端数量限制和 socket 权限。
因此,即使某个会话的 10 分钟空闲超时触发了断开,共享的服务器进程不会被关掉——这正是和 HTTP / rmcp-mux 连接相关的生命周期例外,configuration.md 第 135 行明确说明:关闭 HTTP 或 rmcp-mux 连接不会停止上游服务。另一个会话下次调用时仍然可以立即复用同一个进程,省掉了重新启动的开销。
⚠️ 安全提醒:socket 是信任边界
官方文档特别强调:Unix socket 是一个显式的可信本地端点。rmcp-mux 共享的远不止连接——共享的还有服务器的工具、状态、凭据和文件系统访问。所以:
- 除非你确实打算共享这些资源,否则不要把无关的项目或用户指向同一个 rmcp-mux 服务;
- 个人工作机、同一用户下的多个项目之间共享是典型场景;跨用户共享请谨慎。
小结
- 单个 Pi 会话内,pi-mcp-adapter 默认惰性启停已经足够省资源;
- 多会话、多项目同时使用同一个 stdio 服务器时,用 rmcp-mux 的
socket配置让进程真正共享一份,启动成本只付一次; - 记住分工:adapter 只管客户端连接,进程生命周期由 rmcp-mux 负责;
- 更多服务器字段(
lifecycle、idleTimeout、keep-alive等生命周期模式)可查阅 configuration.md,完整对比数据见 pi-builtin-comparison.md。
