1. 什么是关键变更？ #
本文档汇总 2025-06-18 至 2025-11-25 期间，Model Context Protocol (MCP) 规范的重要更新。适合需要了解协议演进、升级实现或评估兼容性的开发者阅读。
| 通俗理解 |
说明 |
| 版本更新说明 |
类似软件的 Release Notes，列出新增能力与行为变化 |
| 升级参考 |
若你基于旧版规范开发，可据此判断需做哪些调整 |
| 完整日志 |
详细变更列表见 GitHub 对比 |
2. 本章你将学到 #
- 主要功能变更（授权、工具、采样、征询等）
- 次要变更（传输、安全、错误处理等）
- 模式与治理相关更新
- 如何快速判断哪些变更与你的项目相关
3. 变更速览 #
| 类别 |
数量 |
关注重点 |
| 主要变更 |
9 项 |
授权发现、图标元数据、工具命名、采样工具调用、任务等 |
| 次要变更 |
10 项 |
stdio 日志、Streamable HTTP、安全最佳实践、征询默认值等 |
| 模式变更 |
1 项 |
请求负载与 RPC 方法解耦 |
| 治理与流程 |
4 项 |
治理结构、SDK 分级体系等 |
4. 主要变更 #
4.1 授权与发现 #
| 变更 |
通俗理解 |
链接 |
| 增强授权服务器发现 |
支持 OpenID Connect Discovery 1.0，便于自动发现授权端点 |
PR #797 |
| 增量范围同意 |
通过 WWW-Authenticate 支持按需扩展授权范围，而非一次性全部同意 |
SEP-835 |
| OAuth Client ID 元数据 |
支持通过文档声明推荐的客户端注册方式，简化客户端配置 |
SEP-991 |
4.2 工具与资源 #
| 变更 |
通俗理解 |
链接 |
| 图标元数据 |
工具、资源、提示可暴露图标（如 icon_url），便于 UI 展示 |
SEP-973 |
| 工具命名指南 |
提供工具命名规范，减少命名冲突、提升可读性 |
SEP-986 |
4.3 征询与采样 #
| 变更 |
通俗理解 |
链接 |
| ElicitResult / EnumSchema 更新 |
支持带标题、无标题、单选、多选等更规范的枚举类型 |
SEP-1330 |
| URL 模式征询 |
支持通过 URL 模式向用户请求额外信息（如选择文件、链接） |
SEP-1036 |
| 采样工具调用 |
采样请求支持 tools 和 toolChoice 参数，允许服务器在采样时调用工具 |
SEP-1577 |
4.4 任务与实验性 #
| 变更 |
通俗理解 |
链接 |
| 任务（实验性） |
支持通过轮询和延迟结果追踪持久化请求，适用于长时间运行的操作 |
SEP-1686 |
5. 次要变更 #
| 变更 |
通俗理解 |
| stdio 日志 |
使用 stdio 传输的服务器可将 stderr 用于所有类型日志（信息、调试、错误），而不仅是错误 |
PR #670 |
| Implementation description |
Implementation 接口新增可选 description 字段，与 MCP 注册表 server.json 对齐 |
PR #1284 |
| Streamable HTTP Origin |
对无效 Origin 头，服务器应返回 HTTP 403 Forbidden |
PR #1439 |
| 安全最佳实践 |
更新指南，涵盖更多攻击向量与缓解措施 |
安全最佳实践 |
| 工具输入验证错误 |
输入验证错误应作为工具执行错误返回，而非协议错误，便于模型自我校正 |
SEP-1303 |
| SSE 轮询与恢复 |
支持通过轮询 SSE 流；恢复始终通过 GET；支持服务器主动断开；事件 ID 编码流身份 |
SEP-1699 |
| RFC 9728 对齐 |
WWW-Authenticate 头可选，可回退到 .well-known 端点 |
SEP-985 |
| 征询默认值 |
征询中 string、number、enum 等基本类型支持默认值 |
SEP-1034 |
| JSON Schema 2020-12 |
确立为 MCP 模式定义默认方言 |
SEP-1613 |
6. 其他模式变更 #
| 变更 |
通俗理解 |
| 请求负载解耦 |
请求负载从 RPC 方法定义中解耦，形成独立的参数模式，便于复用和扩展 |
SEP-1319 |
7. 治理与流程更新 #
8. 谁需要关注？ #
| 角色 |
建议关注 |
| MCP 服务器开发者 |
主要变更、工具命名、图标元数据、工具输入验证错误 |
| MCP 客户端开发者 |
授权发现、征询、采样工具调用、SSE 轮询与恢复 |
| 安全 / 运维 |
授权相关、安全最佳实践、Streamable HTTP Origin |
| SDK 维护者 |
模式变更、JSON Schema、SDK 分级体系 |
9. 完整变更日志 #
自 2025-06-18 至 2025-11-25 的完整变更列表：
GitHub 对比视图