pi-mcp-adapter进阶:rmcp-mux让多个Pi会话共享同一个MCP进程,省资源指南

原创2026-10-11 09:46:011,329 阅读

pi-mcp-adapter进阶:rmcp-mux让多个Pi会话共享同一个MCP进程,省资源指南

pi-mcp-adapter 是一个为 Pi 编码代理(Pi coding agent)提供 Token 高效 MCP 接入的适配器。本文讲解进阶用法:如何用 rmcp-mux 让多个 Pi 会话共享同一个 MCP 进程,避免每个会话各起一份服务器、白白浪费内存和 CPU。

pi-mcp-adapter 项目横幅图

为什么多开会话会浪费资源?

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。
登录后查看全文
pi-mcp-adapter