rpi-acp 源码解读：以 Zed 为例，一个 ACP Client 如何启动并驱动 rpi Agent

bigfish — Wed, 14 Oct 2026 00:04:00 +0800

在 rpi-package 的 rpi-acp 中，ACP 指的是 Agent Client Protocol。这个 package 的实际用途很具体：让 Zed 这样的 ACP Client 通过标准输入输出启动 rpi，并把 rpi 当作一个可以发送 prompt、接收流式更新和处理权限请求的外部 Agent。

本文以 Zed 作为具体客户端，因为仓库提供了完整的 Zed 注册、配置和排错路径；但 rpi-acp 并不是 Zed 专用实现。只要其他客户端支持 ACP v1、JSON-RPC 2.0 和 stdio，并能处理本文介绍的会话与更新方法，同样可以通过 rpi-acp-bridge 启动 rpi。

本文对应 rpi-packages 中的 rpi-acp 0.1.3，主要源码如下：

packages/rpi-acp/
├── src/lib.rs       插件生命周期、ownsStdio、启动服务
├── src/main.rs      独立 rpi-acp-bridge 二进制
├── src/protocol.rs  ACP v1 JSON-RPC 服务与请求分发
├── src/session.rs   每个 ACP session 对应的 rpi RPC 子进程
├── src/history.rs   session 历史保存与回放
└── src/zed.rs       Zed settings.json 注册

源码仓库：https://github.com/pi-rust/rpi-package/tree/master/packages/rpi-acp

rpi-mcp-adapter 源码解读：一个 Rust MCP 适配器如何管理工具调用

bigfish — Wed, 14 Oct 2026 00:04:00 +0800

很多 MCP 文章讲的是“Host、Client、Server”三个概念，但真正接入一个 MCP Server 时，代码要处理的事情远不止发一条 JSON-RPC：配置如何解析？本地进程如何启动？远程 HTTP 会话如何保存？超时后能不能安全退出？工具列表变化后是否重新发现？

这篇文章不再从 MCP 规范泛讲，而是直接阅读 rpi-mcp-adapter 的代码，回答一个具体问题：rpi 是如何把外部 MCP Server 接进自己的工具循环的？

本文对应 rpi-packages 中的 rpi-mcp-adapter 0.2.1，源码范围主要是：

packages/rpi-mcp-adapter/
├── src/lib.rs          插件入口和三个宿主工具
├── src/config.rs       mcpServers 配置解析
├── src/connection.rs   MCP 初始化与 tools 请求构造
├── src/runtime.rs      连接缓存、发现、调用和关闭
├── src/transport.rs    stdio 子进程传输
└── src/http.rs         Streamable HTTP 传输

源码仓库：https://github.com/pi-rust/rpi-package/tree/master/packages/rpi-mcp-adapter

bigfish的网络博客 - 源码分析

rpi-acp 源码解读：以 Zed 为例，一个 ACP Client 如何启动并驱动 rpi Agent

rpi-mcp-adapter 源码解读：一个 Rust MCP 适配器如何管理工具调用