rmcp：Rust 官方 MCP SDK，把协议规范变成可编译的类型系统

如果你给大模型接过工具，八成踩过同一个坑：协议文档写得很清楚，但每次自己撸 JSON-RPC 消息体、自己处理会话、自己做 OAuth 授权、自己管 SSE 重连，代码写完还要祈祷客户端能正常握手。modelcontextprotocol/rust-sdk（crates 上叫 rmcp）就是来解决这件事的——它是 MCP 官方组织维护的 Rust 实现，把 Model Context Protocol 的全部语义沉淀成一套可复用的库。

它是什么：一套"翻译层"，而不是又一个框架

MCP（Model Context Protocol）本质是一套 JSON-RPC 2.0 协议，规定 AI 应用如何发现并调用外部工具、资源和提示词。规范本身与语言无关，但每种语言都得自己造轮子。rmcp 的定位就是那个"Rust 造好的轮子"：

• 协议覆盖：实现稳定的 MCP 2026-07-28 规范，同时向下兼容 2025-11-25 及更早版本；当前 crate 版本 rmcp 3.8.0。
• 双角色：既能写 Server（对外暴露工具），也能写 Client（去调用别人的 Server）。
• 传输方式齐全：stdio（本地子进程）、Streamable HTTP（远程服务）、Worker/进程内嵌入、Unix Socket。
• 宏糖层：配套 rmcp-macros 过程宏，可用 #[tool] / #[tool_router] 之类注解自动生成工具注册与 JSON Schema。

这就好比电气领域的"标准插座"：协议是插座规格，rmcp 是已经做好的插头，不用每次自己接线。

2026-07-28 规范带来了什么

这一轮规范更新相当激进，rmcp 3.0 是配套的大版本：

从 2.x 升级到 3.x 是破坏性变更：会话模型改为无状态、stateful_mode 更名为 legacy_session_mode、最低 Rust 版本抬到 1.88。官方为此专门写了迁移指南 Discussion #969。

代码质量：官方 conformance 全绿

MCP 官方有一套 SDK 分级审计（SEP-1730）。仓库里的 ROADMAP.md 显示 Rust SDK 的 Tier 1 要求已全部达成：

• 服务端/客户端 conformance 在 2025-11-25 与 2026-07-28 两个版本套件均 100% 通过（30/30 场景）。
• 全部 48 项非实验特性在 README 中有文档与示例。
• 治理文档齐全：VERSIONING.md、DEPENDENCY_POLICY.md、ROADMAP.md、SECURITY.md。
• CI 覆盖 fmt、clippy（-D warnings，含逐 feature 的 cargo-hack 校验）、semver-checks、CodeQL、Scorecard、commitlint。

仓库共 223 个 Rust 源文件、117 个测试文件，并维护独立的 conformance/ 套件与官方 @modelcontextprotocol/conformance 测试基线对齐。

上手门槛

门槛在 Rust 侧，而不是协议侧：

• 必装：Rust 1.88+（edition 2024）。老工具链需要先升级。
• 引入：cargo add rmcp --features server，客户端侧用 --features client。功能全部走 Cargo feature 开关（transport-streamable-http-server、auth、schemars、macros 等），编译期按需裁剪。
• 最小服务端：MyServer.serve(stdio()).await?，继承 ServerHandler 实现 call_tool 即可。
• 无 Web UI：这是库不是应用，不带管理界面，也不提供 Dockerfile 一键部署。想看效果直接跑 examples/ 下的 counter、calculator、memory、oauth、task 等 30+ 个示例。

局限与争议

1. 3.0 破坏性变更面较大：协议版本协商、resultType 判别字段、InputRequiredResult 新枚举都要求 handler 返回类型变宽，手写 handler 的用户必须同步改造。
2. 不提供旧版 HTTP+SSE 传输：这是明确的产品决策而非遗漏，2024-11-05 时代的客户端无法直连，需要代理层过渡。
3. 缓存默认偏"乐观"：默认 serve_stale_on_error 在重新拉取失败时返回过期缓存并包装成 Ok，调用方可能看不到真实错误，需显式关闭。
4. 异步心智负担：全程 tokio 异步，阻塞式业务逻辑需要额外处理；安全敏感场景还需评估 request-state 的 HMAC 封存配置。
5. 许可处于迁移期：LICENSE 明确说明项目正从 MIT 转向 Apache-2.0，未取得重新授权的旧贡献仍保留 MIT。

行业意义

MCP 正在成为 AI 工具互联的事实标准，各语言 SDK 的成熟度直接决定了协议的落地速度。官方自维护、多角色、conformance 全绿的 Rust 实现，意味着 Rust 社区可以用类型系统级别的严谨性接入 MCP——这在强调可组合性与长期维护的基础设施型 AI 服务中很关键。它同时也是"SDK 分级审计"这套治理机制的样板：官方用可量化的 conformance 分数约束各家实现，而不是任由生态自由生长。

结论

如果你的团队用 Rust 构建 AI Agent 或 MCP 服务，rmcp 基本是目前最省心的选择：协议细节全覆盖、有官方维护、有迁移文档、有 conformance 保障。唯一需要做足功课的地方是 2.x → 3.x 的升级改造，以及把库嵌入自研框架时合理裁剪 feature 组合以控制编译时间。