MCP 官方 Ruby SDK 进入 Tier 1

MCP 官方 Ruby SDK 进入 Tier 1

September 29, 2026·
Koichi Ito(Ruby SDK 维护者)
·产品发布, MCP, Ruby·MCP, SDK, Ruby, Tier 1, 公告

MCP 的官方 Ruby SDK 现已进入 Tier 1,相关结论记录在 SDK 分级体系下的 Tier 1 评估中。Ruby 成为继 TypeScript、Python、C#、Go、Rust 之后的第六个 Tier 1 SDK,满足了该等级对完整功能支持、100% 一致性通过率以及带响应时限的维护承诺的全部要求。

完整支持 2026-07-28 修订

mcp gem 的 1.2.0 版本完成了对 2026-07-28 修订的支持:

  • 无状态生命周期(SEP-2575)与经典会话握手并存提供服务,包括 server/discover 与 subscriptions/listen 通知流
  • 多轮往返请求(SEP-2322)在服务器端与客户端均可用,内置兼容层让以新 input_required 风格编写的处理器无需改动即可服务 2026 之前的客户端
  • 缓存提示(SEP-2549)与标准及自定义 HTTP 请求头(SEP-2243)在 modern 路径上照常发出并校验
  • Roots、Sampling 与 Logging 按 SEP-2577 标记为废弃;以 2026-07-28 协议版本连接的客户端在声明 Roots 或 Sampling 能力时会收到警告

服务器同时服务两个生命周期世代:现有客户端继续工作,2026-07-28 客户端走无状态路径。SDK 如何处理各世代见 Protocol Versions。自 1.2.0 起的多个 1.x 小版本在 SDK 版本策略的规范一致性与安全例外条款下收紧了校验,升级既有 1.x 应用时请查阅 changelog。

从 Tier 2 到 Tier 1

七月的 Tier 2 评估记录了通往 Tier 1 的两个缺口:文档覆盖度,以及跟进新规范修订的商定时间表。此后:

  • SDK 在 2025-11-25 与 2026-07-28 两套要求集上的计分服务器与客户端一致性场景全部通过(100%),由一致性测试套件按修订冻结计分测得:服务器场景 67/67、客户端场景 50/50,各自以该修订自身的线上版本执行
  • 每个已实现功能都有文字与示例文档,从非文本内容类型、信息征询选项到完整 OAuth 客户端流程;1.3.0 版本起,文档从 README 迁移到改版后的文档站,每主题一页
  • 仓库在 Tier 1 时限内保持了 100% 的 issue 分诊率,且无 P0 issue

包括一致性结果复现步骤在内的完整证据表见 Tier 1 评估。

支持 2026-07-28 的稳定版在规范发布约两周后交付,而 Tier 1 期望在发布日即提供支持。为弥补这一规范跟进缺口,Ruby SDK 团队已承诺在下一个修订(目前计划 2026-12-15)的发布日当天提供支持。

这段路短而陡:SDK 于 2026 年 3 月获评 Tier 3,7 月随 1.0 发布进入 Tier 2,8 月申请 Tier 1,9 月获批。

开始使用

安装或升级 gem 到最新版本(撰写本文时为 v1.6.1):

$ gem install mcp

如果你的 Gemfile 仍把 gem 固定在 0.x 版本,请更新约束以获取最新功能集:

gem 'mcp', '>= 1.6'

或者保持在 1.x 系列内:

gem 'mcp', '~> 1.6'

已经在运行 1.x 服务器的话,升级后即可在服务现有客户端的同时服务 2026-07-28 客户端。构建服务器与客户端(含 Rails 集成)的指南见 Ruby SDK 文档,基础入门可参阅 1.0 发布说明。

反馈

使用 SDK 时遇到问题或异常行为,请在 issue tracker 上报告。来自真实使用的反馈尤其宝贵,Tier 1 也带来了快速分诊的承诺。

Ruby SDK 由 Topher Bullock、Koichi Ito、Ateş Göral 与 Jonathan Hefner 以及更广泛的 Ruby 社区共同维护。感谢一路上提供反馈与贡献的每一个人。特别感谢 Felix Weinberger 与 Paul Carleton 对 Tier 1 评估的评审与独立验证,以及 Den Delimarsky 的终审。