Skip to main content
最终版标准轨道
字段值
SEP1699
标题通过服务器端断开支持 SSE 轮询
状态最终版
类型标准轨道
创建日期2025-10-22
作者Jonathan Hefner (@jonathanhefner)
赞助人无
PR#1699

​
摘要

本 SEP 提议对 Streamable HTTP 传输进行更改，以缓解有关长连接和可恢复性的问题。

​
动机

Streamable HTTP 传输规范 不允许 服务器在计算结果时关闭连接。换句话说，除非客户端断开连接，否则服务器必须维持可能长期运行的连接。

​
规范

当服务器启动 SSE 流时，它必须立即发送一个包含 id 和空 data 字符串的 SSE 事件，以便让客户端准备好使用该事件 ID 作为 Last-Event-ID 进行重连。 请注意，SSE 标准明确 允许将 data 设置为空字符串，并指出适当的客户端处理是记录 id 用于 Last-Event-ID，但否则忽略该事件（即，不调用事件处理回调）。 在服务器向客户端发送事件 ID 后的任何时间点，服务器可以随时断开连接。具体来说，MCP 规范的这一部分 将从：
服务器在发送收到的 JSON-RPC 请求 的 JSON-RPC 响应 之前 不应 关闭 SSE 流
改为：
如果服务器已向客户端发送了带有事件 ID 的 SSE 事件，则 可以 在发送 JSON-RPC 响应 之前关闭连接
如果服务器断开连接，客户端将把断开连接解释为网络故障，并尝试重新连接。为了防止客户端过度重新连接/轮询，服务器应该发送一个带有 retry 字段的 SSE 事件，指示客户端在重新连接之前应该等待多长时间。客户端必须遵守 retry 字段。

​
理由

服务器可以随时断开连接，避免长连接。发送 retry 字段将防止客户端用不适当的重新连接尝试冲击服务器。

​
向后兼容性

  • 新客户端 + 旧服务器：无变化。无向后不兼容性。
  • 旧客户端 + 新服务器：客户端应将随时断开连接解释为网络故障。retry 字段是 SSE 标准的一部分。如果客户端已经实现了正确的 SSE 恢复逻辑，则没有向后不兼容性。

​
附加信息

本 SEP 部分取代 SEP-1335。