Skip to content

关键变更

本文档列出了自上一版本 2025-06-18 以来对 Model Context Protocol (MCP) 规范所做的更改。

1. 主要变更

  1. 通过支持 OpenID Connect Discovery 1.0 增强授权服务器发现。(PR #797)

  2. 允许服务器为工具、资源、资源模板和提示公开图标作为额外的元数据 (SEP-973)。

  3. 通过 WWW-Authenticate 增强授权流程,支持增量作用域同意 (SEP-835)

  4. 提供工具名称指南 (SEP-986)

  5. 更新 ElicitResultEnumSchema 以使用更基于标准的方法,并支持带标题、无标题、单选和多选的枚举 (SEP-1330)。

  6. 添加对 URL 模式引导 的支持 (SEP-1036)

  7. 通过 toolstoolChoice 参数为采样添加工具调用支持 (SEP-1577)

  8. 添加对 OAuth Client ID Metadata Documents 作为推荐的客户端注册机制的支持 (SEP-991, PR #1296)

  9. 添加对任务的实验性支持,以启用对持久请求的轮询和延迟结果检索的跟踪 (SEP-1686)。

2. 次要变更

  1. 澄清使用 stdio 传输的服务器可以使用 stderr 进行所有类型的日志记录,而不仅仅是错误消息 (PR #670)。

  2. Implementation 接口添加可选的 description 字段,以与 MCP 注册表 server.json 格式保持一致,并在初始化期间提供人类可读的上下文。

  3. 澄清服务器必须对 Streamable HTTP 传输中无效的 Origin 头响应 HTTP 403 Forbidden。(PR #1439)

  4. 更新了安全最佳实践指南

  5. 澄清输入验证错误应作为工具执行错误而非协议错误返回,以启用模型自我纠正 (SEP-1303)。

  6. 通过允许服务器随时断开连接来支持轮询 SSE 流 (SEP-1699)。

  7. 澄清 SEP-1699:GET 流支持轮询,无论流来源如何,恢复总是通过 GET 进行,事件 ID 应编码流标识,断开连接包括服务器发起的关闭 (Issue #1847)。

  8. 将 OAuth 2.0 Protected Resource Metadata 发现与 RFC 9728 对齐,使 WWW-Authenticate 头成为可选,并回退到 .well-known 端点 (SEP-985)。

  9. 为引导模式中的所有原始类型(字符串、数字、枚举)添加默认值支持 (SEP-1034)。

  10. 将 JSON Schema 2020-12 确立为 MCP 模式定义的默认方言 (SEP-1613)。

3. 其他模式变更

  1. 将请求负载与 RPC 方法定义解耦为独立的参数模式。(SEP-1319, PR #1284)

4. 治理和流程更新

  1. 正式化 Model Context Protocol 治理结构 (SEP-932)。

  2. 为 MCP 社区建立共享的沟通实践和指南 (SEP-994)。

  3. 在 MCP 治理中正式化工作组和兴趣小组 (SEP-1302)。

  4. 建立 SDK 分层系统,明确功能支持要求和维护承诺 (SEP-1730)。

5. 完整变更日志

有关自上次协议修订以来所做的所有更改的完整列表,请参阅 GitHub