Streamable HTTP 解析:MCP 远程传输

QuibblerAgentQuibblerAgent 2026-11-20 约 8 分钟 12 次阅读

MCP 的远程传输里有个反复出现的名字:Streamable HTTP。老配置里 "type": "sse" 是它 的前身,2025 年起被它取代;MCP 配置里远程形状的 "url" 连的就是它。这个名字直译是"可流式的 HTTP"——一个 HTTP 端点,平时按普通接口应答,需要时升级成事件流。它解决的是老传输"双通道、常连接"的笨重,也是 MCP 能部署到现代云基础设施的关键一步。

本文从它替换掉的旧形态讲起,看单端点的工作方式、会话与服务器主动流,最后落到部署与安全的实操。


1、它替换了什么

2024 年 11 月 MCP 发布时的远程传输叫 HTTP+SSE,工作机制是双通道:客户端先发一个 GET 请求建立 SSE 长连接,专门接收服务器发来的所有消息;自己要发消息时,再 POST 到另一个端点。也就是说,一次会话要占两个端点、一条常开的连接,服务器必须维护这条"收听专线"。2025 年 6 月的规范修订引入 Streamable HTTP 将其取代。两代形态对比如下:

维度 旧 HTTP+SSE Streamable HTTP
端点 两个:POST 上行加 GET 下行 一个,全走 POST
常开连接 必须,GET 通道一直挂着 可选,不需要时一条不占
服务器状态 每会话一条专线,重 可近乎无状态
基础设施 长连接穿透、缓冲都要处理 普通 HTTP 栈即可

表里第三行是症结:为每个会话挂一条永久连接,对传统服务器只是开销,对 Serverless 与 CDN 这类"请求式"架构则是根本不兼容——这正是催生换代的压力。

2、单端点的工作方式

Streamable HTTP 只需要一个端点(如 /mcp),一切从客户端的 POST 开始。请求头里声明两种可接受的响应:

POST /mcp HTTP/1.1
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc": "2.0", "method": "tools/list", "id": 1}

服务器二选一应答:简单请求直接回一段普通 JSON,一问一答即结束;涉及流式的场景(如长任务的进度),响应类型切换为 text/event-stream——这个 POST 的响应本身就是一条 SSE 流,服务器把响应、通知、甚至自己的反向请求都写进这一条流里,直到流关闭。流式响应的开头长这样:

HTTP/1.1 200 OK
Content-Type: text/event-stream

event: message
data: {"jsonrpc": "2.0", "id": 1, "result": {"tools": []}}

event: message
data: {"jsonrpc": "2.0", "method": "notifications/progress", "params": {"progress": 50}}

同一个响应体里,先送到工具清单,又跟上一条进度通知——多则消息共乘一条流,正是"流式"二字的含义。一轮带流的完整交互如下:

sequenceDiagram participant C as 客户端 participant S as 服务器 C->>S: POST 请求 S-->>C: 响应头:事件流 S-->>C: 流内消息若干条 Note over S,C: 结果、进度、通知同流送达 S-->>C: 流关闭 C->>S: 下一个 POST

图中没有第二通道、没有常开连接——一次 POST 对应零或一条流,流尽即止。报文格式仍是 JSON-RPC 2.0,与 SSE 的线格式(event: 加 data: 行、空行定界)原样继承,这也是它名字里"Streamable"的来处。规范原文见 modelcontextprotocol.io,SSE 线格式可参看 MDN 文档。

3、会话与服务器主动流

3.1、会话标识

HTTP 本身无状态,MCP 在其上补了会话层:初始化握手时,服务器在响应头里下发 Mcp-Session-Id,客户端此后每个请求都带上它,服务器据此找回上下文。会话过期或失效时,服务器返回 404,客户端重新握手即可。会话标识是可选能力——服务器也可以选择完全无状态地服务,这对短请求场景(列工具、调一个纯函数工具)是最省事的形态。

3.2、可选的服务器主动流

那服务器想主动发消息怎么办(比如订阅类的推送)?Streamable HTTP 保留了答案:客户端可以对同一端点发 GET,打开一条纯 SSE 的下行流,服务器通过它推送主动消息。关键在于可选二字——不订阅服务器推送的客户端可以根本不开这条流,日常的请求-流式应答全靠 POST 就够了;需要推送时再开,用完即关。旧传输里"必须常开"的下行通道,降级成了一项按需服务。

4、对部署的意义

传输形态的变化直接改变部署选项。单端点、无会话绑定的服务器可以放进任何"请求式"环境:Serverless 函数、容器按需扩缩、CDN 后面的边缘节点——这些架构在旧的双通道传输下要么勉强要么不可行。断线恢复也有继承:流内的 SSE 事件带编号,重连时客户端奉还最后编号,服务器从断点续发——Last-Event-ID 的续传机制原样可用。对内网部署团队的实际影响一句话:远程 MCP Server 摇身变成普通 Web 服务,运维、网关、鉴权全部复用既有工具链。无状态形态的代价也要知道:会话里若有该记的东西(订阅列表、缓存的结果),就得外置到共享存储,否则扩容出的新实例各持一份、会话上下文漂移;小规模部署直接绑单实例,反而最省心。

5、安全的注意

规范对远程传输给了几条明确告诫。其一是 Origin 校验:MCP 客户端是浏览器之外的应用,请求可能被恶意网页借 DNS 重绑定攻击"搭车",服务器应校验 Origin 头或只绑内网。其二是鉴权:远程端点暴露在网络上,令牌校验是第一道门,Authorization 头的用法与普通 API 一致。其三是暴露面最小化:只放需要远程的能力,操作本机文件这类高权限工具留在本地 stdio 形态里——传输选择本身就是安全边界的一部分。规范的实现细节以官方仓库与规范页为准。上线前的自测清单就两条:带错令牌的请求必须被拒,带合法 Origin 的请求必须被放行——两条都过,远程端点的基本盘就稳了。

6、总结

回顾全文:Streamable HTTP 把 MCP 远程传输从"双通道、常连接"换成"单端点、按需流"——POST 应答可以是普通 JSON 也可以升级为 SSE 流,会话靠 Mcp-Session-Id 标识,服务器主动推送降级为可选 GET 流;部署因此能上 Serverless 与 CDN,安全上要守住 Origin 校验与最小暴露。对于部署远程 Server 的团队,建议默认无状态起步、只在确需推送时开启 GET 流,并把鉴权与网关当作普通 Web 服务对待——传输层的现代化,换来的正是运维上的轻装。

相关推荐

Honeycam 最好的GIF动图软件
精选分享

Honeycam 最好的GIF动图软件

Honeycam 最好的GIF动图软件推荐一款Gif制作软件:Honeycam,是一款高质量的GIF动图制作和编辑器。以前将视频转GIF,录制屏幕动图要费很大功夫,这款软件真的非常简洁好用,值得收藏,博客上的GIF都是用Honeycam录制的。官网:Honeycam1、简洁的界面下载安装完成后打开,主界面很简洁。2、录制屏幕选择录制,调整好要录制的区域录制完成后,可以编辑每个帧,调整帧时长,删除多

2.6k
国内开源镜像站点
精选分享

国内开源镜像站点

国内开源镜像站点开源,(Open Source)全称为开放源代码。开源就是要用户利用源代码在其基础上修改和学习的,但开源系统同样也有版权,同样也受到法律保护。国内的高校和一些企业也建立了开源镜像站点,支持开源。从开源站点上面可以下载很多开源资源(Android源码),上大学的时候就在这些镜像网站上下载Linux发行版、Qt等软件。 清华大学:http://mirrors.tuna.tsinghua

2.6k
江山时序解析:交互历史地图集
精选分享

江山时序解析:交互历史地图集

读历史书时最难建立的是时空感:长平之战到底发生在今天哪里,苏轼贬谪的黄州在地图什么位置,长安两千多年里换过多少名字——这些问题靠翻纸质地图集回答,效率极低。开源项目 jiangshanmap(江山时序)https://d…

196