文章目录

• MCP 的 streamable_http 与 SSE 前后区别是什么：原理剖析和源代码详解
• • • 1. 核心架构区别
    • 2. 为什么要从 SSE 升级到 Streamable HTTP？
    • 3. 交互流程对比
    • 总结
• =====================================
• • 一句话结论
  • 时间线（“前后”指的就是这些版本）
  • 旧 SSE transport vs 新 Streamable HTTP：逐点对比
  • • 1) Endpoint 结构：两条 URL → 一条 URL
    • 2) 客户端发消息方式：固定 POST URL + 手摇协议 → 每条消息一次 POST（更“HTTP 化”）
    • 3) 服务端回消息方式：只能走 SSE → 可以 JSON 也可以 SSE
    • 4) 服务端主动推送：从“默认走那条 SSE 长连接” → 规范化为 GET 开 SSE
    • 5) 断线恢复/补发：旧版没标准答案 → 新版把 `Last-Event-ID`、重放规则写进规范
    • 6) Session：从“各家自定义” → 规范化 `MCP-Session-Id`
  • 工程上的“最常见坑”（你大概率就是在这卡住）
  • • 坑 1：浏览器原生 `EventSource` 不能加自定义 headers
    • 坑 2：SSE 连接数限制（浏览器侧）
  • SDK 配置名的对应关系（你看到的 `streamable_http` 是什么）
  • 迁移时你应该怎么理解“前后差异”（实操版）
• ================================================
• • • 场景设定
    • 1. Legacy SSE (双通道模式)
    • • 后端代码 (Server)
      • 前端代码 (Client)
    • 2. Streamable HTTP (单通道模式)
    • • 后端代码 (Server)
      • 前端代码 (Client)
    • 关键差异总结
• =================================================
• • A) Legacy SSE transport（HTTP+SSE，旧版，两条 endpoint）
  • • 协议要点（对应你要对比的“差异”）
    • 1) 后端：`legacy-sse-server.js`（Node + Express）
    • 2) 前端：`legacy-sse-client.html`（浏览器：EventSource + fetch POST）
  • B) Streamable HTTP（新 transport：单一 /mcp，POST/GET，可选 SSE）
  • • 协议要点（对应你要对比的“差异”）
    • 1) 后端：`streamable-http-server.js`（Node + Express）
    • 2) 前端：`streamable-http-client.html`（浏览器：fetch 处理 JSON 或 SSE）
  • 你用这两套代码做对比时，应该看到的“网络形态差异”
  • • Legacy SSE（旧）
    • Streamable HTTP（新）