传输

1. stdio，通过标准输入和标准输出进行通信
2. Streamable HTTP

​

stdio

• 客户端将 MCP 服务器作为子进程启动。
• 服务器从其标准输入（stdin）读取 JSON-RPC 消息，并将消息发送到其标准输出（stdout）。
• 消息是单独的 JSON-RPC 请求、通知或响应。
• 消息由换行符分隔，且 不得 包含嵌入式换行符。
• 服务器 可以 向其标准错误（stderr）写入 UTF-8 字符串，用于任何日志记录目的，包括信息、调试和错误消息。
• 客户端 可以 捕获、转发或忽略服务器的 stderr 输出，且 不应 假设 stderr 输出表示错误条件。
• 服务器 不得 向其 stdout 写入任何非有效 MCP 消息的内容。
• 客户端 不得 向服务器的 stdin 写入任何非有效 MCP 消息的内容。

​

Streamable HTTP

​

安全警告

1. 服务器 必须 验证所有传入连接上的 Origin 头，以防止 DNS 重绑定攻击
   • 如果 Origin 头存在且无效，服务器 必须 响应 HTTP 403 Forbidden。HTTP 响应体 可以 包含一个没有 id 的 JSON-RPC 错误响应
2. 在本地运行时，服务器 应该 仅绑定到 localhost (127.0.0.1)，而不是所有网络接口 (0.0.0.0)
3. 服务器 应该 为所有连接实现适当的身份验证

​

向服务器发送消息

1. 客户端 必须 使用 HTTP POST 向 MCP 端点发送 JSON-RPC 消息。
2. 客户端 必须 包含一个 Accept 头，列出 application/json 和 text/event-stream 作为支持的内容类型。
3. HTTP POST 请求的体 必须 是单个 JSON-RPC 请求、通知 或对服务器发送请求的 响应。
4. 如果体是 JSON-RPC 通知 或对服务器发送请求的 响应：
   • 如果服务器接受输入，服务器 必须 返回 HTTP 状态码 202 Accepted，且不带体。
   • 如果服务器无法接受输入，它 必须 返回 HTTP 错误状态码（例如，400 Bad Request）。HTTP 响应体 可以 包含一个没有 id 的 JSON-RPC 错误响应。
5. 如果体是 JSON-RPC 请求，服务器 必须 要么返回 Content-Type: text/event-stream 以启动 SSE 流，要么返回 Content-Type: application/json 以返回一个 JSON 对象。客户端 必须 支持这两种情况。
6. 如果服务器启动 SSE 流：
   • 服务器 应该 立即发送一个包含事件 ID 和空 data 字段的 SSE 事件，以便让客户端准备好重新连接（使用该事件 ID 作为 Last-Event-ID）。
   • 在服务器向客户端发送了带有事件 ID 的 SSE 事件后，服务器 可以 随时关闭 连接（而不终止 SSE 流），以避免保持长连接。客户端 应该 然后通过尝试重新连接来“轮询”SSE 流。
   • 如果服务器在终止 SSE 流 之前关闭了 连接，它 应该 在关闭连接之前发送一个带有标准 retry 字段的 SSE 事件。客户端 必须 遵守 retry 字段，在尝试重新连接之前等待指定的毫秒数。
   • SSE 流 应该 最终包含针对 POST 体中发送的 JSON-RPC 请求 的 JSON-RPC 响应。
   • 在发送 JSON-RPC 响应 之前，服务器 可以 发送 JSON-RPC 请求 和 通知。这些消息 必须 与发起的客户端 请求 相关。
   • 如果 会话 过期，服务器 可以 终止 SSE 流。
   • 在发送 JSON-RPC 响应 后，服务器 应该 终止 SSE 流。
   • 断开连接 可以 随时发生（例如，由于网络条件）。因此：
     • 断开连接 不应 被解释为客户端取消了其请求。
     • 要取消，客户端 应该 显式发送一个 MCP CancelledNotification。
     • 为了避免因断开连接而丢失消息，服务器 可以 使流 可恢复。

​

监听来自服务器的消息

1. 客户端 可以 向 MCP 端点发出 HTTP GET。这可用于打开 SSE 流，允许服务器与客户端通信，而无需客户端首先通过 HTTP POST 发送数据。
2. 客户端 必须 包含一个 Accept 头，列出 text/event-stream 作为支持的内容类型。
3. 服务器 必须 要么在此 HTTP GET 响应中返回 Content-Type: text/event-stream，要么返回 HTTP 405 Method Not Allowed，表明服务器在此端点不提供 SSE 流。根据 RFC 9110 §15.5.6，如果服务器返回 HTTP 405，它 必须 包含一个 Allow 头，列出它支持的方法（例如，Allow: POST）。
4. 如果服务器启动 SSE 流：
   • 服务器 可以 在流上发送 JSON-RPC 通知 和 pings。
   • 这些消息 应该 与任何并发运行的客户端 JSON-RPC 请求 无关，除了 roots/list、sampling/createMessage 和 elicitation/create 请求 不得 在独立流上发送。
   • 除非 恢复 与先前客户端请求关联的流，否则服务器 不得 在流上发送 JSON-RPC 响应。
   • 服务器 可以 随时关闭 SSE 流。
   • 如果服务器在不终止 流 的情况下关闭 连接，它 应该 遵循与 POST 请求描述的相同的轮询行为：发送 retry 字段并允许客户端重新连接。
   • 客户端 可以 随时关闭 SSE 流。

​

多连接

1. 客户端 可以 同时保持连接到多个 SSE 流。
2. 服务器 必须 仅在其中一个连接的流上发送其每条 JSON-RPC 消息；也就是说，它 不得 在多个流上广播相同的消息。
   • 消息丢失的风险 可以 通过使流 可恢复 来减轻。

​

可恢复性和重新交付

1. 服务器 可以 为其 SSE 事件附加一个 id 字段，如 SSE 标准 中所述。
   • 如果存在，该 ID 在该 会话 内的所有流中 必须 是全局唯一的——或者如果未使用会话管理，则在与该特定客户端的所有流中唯一。
   • 事件 ID 应该 编码足够的信息以识别源流，使服务器能够将 Last-Event-ID 关联到正确的流。
2. 如果客户端希望在断开连接后恢复（无论是由于网络故障还是服务器发起的关闭），它 应该 向 MCP 端点发出 HTTP GET，并包含 Last-Event-ID 头，以指示它收到的最后一个事件 ID。
   • 服务器 可以 使用此头重放本应在 断开的流 上的最后一个事件 ID 之后发送的消息，并从该点恢复流。
   • 服务器 不得 重放本应在不同流上交付的消息。
   • 此机制适用于原始流是如何启动的（通过 POST 或 GET）。恢复始终通过带有 Last-Event-ID 的 HTTP GET 进行。

​

会话管理

1. 使用 Streamable HTTP 传输的服务器 可以 在初始化时分配一个会话 ID，方法是在包含 InitializeResult 的 HTTP 响应的 MCP-Session-Id 头中包括它。
   • 会话 ID 应该 是全局唯一且加密安全的（例如，安全生成的 UUID、JWT 或加密哈希）。
   • 会话 ID 必须 仅包含可见的 ASCII 字符（范围从 0x21 到 0x7E）。
   • 客户端 必须 以安全方式处理会话 ID，有关更多详细信息，请参阅 会话劫持缓解措施。
2. 如果服务器在初始化期间返回了 MCP-Session-Id，使用 Streamable HTTP 传输的客户端 必须 在其所有后续 HTTP 请求的 MCP-Session-Id 头中包含它。
   • 需要会话 ID 的服务器 应该 响应没有 MCP-Session-Id 头的请求（初始化除外），返回 HTTP 400 Bad Request。
3. 服务器 可以 随时终止会话，之后它 必须 响应包含该会话 ID 的请求，返回 HTTP 404 Not Found。
4. 当客户端收到针对包含 MCP-Session-Id 的请求的 HTTP 404 响应时，它 必须 通过发送一个新的不带会话 ID 的 InitializeRequest 来启动新会话。
5. 不再需要特定会话的客户端（例如，因为用户正在离开客户端应用程序） 应该 向 MCP 端点发送带有 MCP-Session-Id 头的 HTTP DELETE，以显式终止会话。
   • 服务器 可以 响应此请求，返回 HTTP 405 Method Not Allowed，表明服务器不允许客户端终止会话。如果服务器返回 HTTP 405，它 必须 包含一个 Allow 头，列出它支持的方法。

​

序列图

​

协议版本头

​

SSE 流配置

​

向后兼容性

• 继续托管旧传输的 SSE 和 POST 端点，与为 Streamable HTTP 传输定义的新”MCP 端点”一起。
  • 也可以组合旧的 POST 端点和新的 MCP 端点，但这可能会引入不必要的复杂性。

1. 接受用户提供的 MCP 服务器 URL，该 URL 可能指向使用旧传输或新传输的服务器。
2. 尝试向服务器 URL POST 一个 InitializeRequest，带有如上定义的 Accept 头：
   • 如果成功，客户端可以假设这是一个支持新 Streamable HTTP 传输的服务器。
   • 如果失败，返回以下 HTTP 状态码”400 Bad Request”、“404 Not Found”或”405 Method Not Allowed”：
     • 向服务器 URL 发出 GET 请求，期望这将打开一个 SSE 流并作为第一个事件返回一个 endpoint 事件。
     • 当 endpoint 事件到达时，客户端可以假设这是一个运行旧 HTTP+SSE 传输的服务器，并且应该在所有后续通信中使用该传输。

​

自定义传输