主要变更
-
从 Streamable HTTP 传输中移除协议层会话和
Mcp-Session-Id头。列表端点(tools/list、resources/list、prompts/list)不再按连接变化。需要跨调用状态的服务器使用由服务器生成的显式句柄,并将其作为普通工具参数传递(SEP-2567)。 -
使 MCP 无状态:移除
initialize/notifications/initialized握手。现在每个请求都在_meta中携带其协议版本、客户端身份和客户端能力(io.modelcontextprotocol/protocolVersion、io.modelcontextprotocol/clientInfo、io.modelcontextprotocol/clientCapabilities)。版本不匹配会返回UnsupportedProtocolVersionError(SEP-2575)。 -
添加
server/discover:服务器 MUST 实现此 RPC,以声明其支持的协议版本、能力和身份。客户端 MAY 在任何其他请求之前调用它以预先选择版本,或将其作为 STDIO 上的向后兼容探测(SEP-2575)。 -
用
subscriptions/listen替代 HTTP GET 端点以及resources/subscribe/resources/unsubscribe:这是一个单一的长生命周期 POST 响应流,用于选择加入的服务器到客户端变更通知。客户端选择加入特定类型(toolsListChanged、promptsListChanged、resourcesListChanged、resourceSubscriptions);服务器确认订阅,并使用io.modelcontextprotocol/subscriptionId标记通知。请求作用域的通知(例如notifications/progress和notifications/message)继续在其相关请求的响应流上传递,而不是在subscriptions/listen流上传递(SEP-2575)。 -
移除
ping、logging/setLevel和notifications/roots/list_changed。现在日志级别通过_meta中的io.modelcontextprotocol/logLevel按请求设置;对于未包含此字段的请求,服务器 MUST NOT 发出notifications/message(SEP-2575)。 -
将实验性任务从核心协议移出,放入官方扩展(
io.modelcontextprotocol/tasks)。重新设计的扩展用通过tasks/get轮询以及用于客户端到服务器输入的新tasks/update替代阻塞式tasks/result方法,移除tasks/list,并允许服务器在未按请求选择加入的情况下主动返回任务句柄(SEP-2663)。 -
引入多轮往返请求(Multi Round-Trip Requests,MRTR)模式,用来替代以前发送服务器发起请求的做法,例如
roots/list、sampling/createMessage或elicitation/create。服务器返回inputRequests,这是一种新的resultType,包含处理该请求所需的额外信息。客户端在下一次请求中用inputResponses提供所请求的信息。(SEP-2322)。
次要变更
- 向
ClientCapabilities和ServerCapabilities添加extensions字段,以支持核心协议之外的可选扩展。 - 记录
_meta键(traceparent、tracestate、baggage)的 OpenTelemetry trace context 传播约定(SEP-414)。 - 服务器 SHOULD 以确定性顺序从
tools/list返回工具,以支持客户端缓存并提高 LLM 提示缓存命中率。 - 要求 Streamable HTTP POST 请求携带标准 MCP 请求头(
Mcp-Method、Mcp-Name),并添加通过工具参数中的x-mcp-header支持自定义头的能力(SEP-2243)。 - 通过新的
CacheableResult接口,要求tools/list、prompts/list、resources/list、resources/read和resources/templates/list返回的结果包含ttlMs和cacheScope字段。ttlMs是新鲜度提示(以毫秒为单位),允许客户端缓存响应并减少轮询;cacheScope("public"或"private")控制共享中介是否可以缓存响应。这两个字段补充现有的listChanged通知(SEP-2549)。 - 将资源未找到错误码从
-32002改为-32602(Invalid Params),以与 JSON-RPC 规范保持一致。 - 授权服务器 SHOULD 按
RFC 9207 在授权响应中包含
iss参数,并且 MCP 客户端 MUST 在兑换授权码之前,根据记录的签发者校验出现的iss(SEP-2468)。 - 要求 MCP 客户端在动态客户端注册期间指定适当的
application_type,以避免 OpenID Connect 重定向 URI 冲突 (SEP-837)。 - 明确客户端凭据绑定到签发它们的授权服务器: 客户端 MUST 按签发者标识符为持久化凭据建立键,MUST NOT 将它们复用于不同的授权服务器,并且当授权服务器变化时 MUST 重新注册(SEP-2352)。
- 放宽
inputSchema和outputSchema,允许任何 JSON Schema 2020-12 关键字,并放宽structuredContent,允许任何 JSON 值。添加$ref解析要求和组合关键字资源边界 (SEP-2106)。
已弃用
此处列出的特性仍是规范的一部分,但已根据特性生命周期和弃用政策计划移除。新实现不应采用它们。已弃用特性注册表跟踪当前处于 Deprecated 状态的所有特性。-
弃用根目录、采样和日志特性
(SEP-2577)。
这些特性在弃用窗口期内仍保持完整功能,但新实现不应再添加对它们的支持。建议迁移:
使用工具参数、资源 URI 或服务器配置传递目录或文件,而不是使用根目录;直接集成
LLM 提供商 API,而不是使用采样;将日志写入
stderr(stdio)或使用 OpenTelemetry, 而不是使用日志特性。 -
根据特性生命周期政策,将 HTTP+SSE 传输(自协议版本
2025-03-26起弃用)重新分类为 Deprecated (SEP-2596)。 迁移到 Streamable HTTP。 -
将
includeContext值"thisServer"和"allServers"(自协议版本2025-11-25起软弃用)重新分类为 Deprecated (SEP-2596)。 省略该字段或使用"none";这些值最迟会与采样特性本身一起移除。 - 弃用作为客户端注册机制的 OAuth 2.0 动态客户端注册协议 (RFC7591),改为推荐 客户端 ID 元数据文档 (PR #2858)。 为了向后兼容不支持客户端 ID 元数据文档的授权服务器,它仍然可用。
其他 schema 变更
schema.json现在正确反映 TypeScript 中 minimum/maximum/default 的定义是number,而不只是integer。此前的问题是使用--defaultNumberType integer运行生成器导致的(PR#2710)。
治理和流程更新
- 采用规范的 特性生命周期和弃用政策,定义 Active、Deprecated 和 Removed 特性状态、至少十二个月的弃用窗口,以及 已弃用特性注册表 (SEP-2596)。
流程变更
- 正式化基于 PR 的 SEP 工作流,包括
seps/目录中的 markdown 文件、从 PR 派生的编号、发起人职责,以及通过 PR 标签进行状态管理(SEP-1850)。