再见，SSE！你好，Streamable HTTP！轻松开发 Streamable HTTP MCP Server

最新推荐文章于 2025-07-03 12:11:13 发布
转载 最新推荐文章于 2025-07-03 12:11:13 发布 · 36 阅读 · 0
文章标签：

#http #网络协议 #网络

大家好！我是韩老师。

之前和大家分享了三篇 MCP 相关的文章：

还是那句话：也许有一天，AI 程序员不懂 MCP，就犹如前端程序员不懂 JavaScript！

相信不少童鞋已经了解了甚至参与到了 MCP 相关的开发。

从 MCP 支持的两个协议 stdio 和 SSE 来看，MCP 确实有点“快而糙”。如果我当年本科的暑假大作业，还有一天就要deadline了，我也许才会选择这两个协议，能让我快速出活。

在第一篇文章中，我就提到了 stdio 和 SSE 的的“快而糙”。

SSE 的最大缺陷之一，显而易见：SSE 需要 server 端保持一个长连接，而且，根据 MCP 的协议，在 MCP Client 与 MCP Server 建立 SEE 连接后，在整个 connection 的生命周期中，MCP Server 需要一直保持着这个 SSE 连接。

那么，对于要支持 SSE 的运行在 remote 的 MCP Server 来说，就需要保证高可靠性。在高并发的情况下，对 MCP Server 的负载更是一个挑战。

在 3 月 26 日，MCP 发布了最新的 spec，用 Streamable HTTP “取代”了 SSE。

简单来说，在新的 Streamable HTTP 协议中，MCP Server 可以根据自己实际的使用场景来决定自己是 Stateless 还是 Stateful 的，而不是像 SSE 那样，一定是 Stateful 的。

这对开发 Remote MCP Server 的开发者来说，真是一个极好的消息，因为在不少场景中，Stateless server 会对 MCP Server 的要求降低很多！

今天，我也要和大家分享个好消息，韩老师的 Code Runner MCP Server 和 Yeoman Generator for MCP Server 都已经支持 Streamable HTTP 啦！

现在，韩老师就用 Yeoman Generator for MCP Server，来带领大家快速开发一个 Streamable HTTP 的 MCP Server！

安装 Node.js

从  安装 LTS 版的 Node.js 即可。

安装 Scaffolding Tool

在命令行运行下面命令，安装 Yeoman Generator for MCP Server：

npm install -g yo generator-mcp@latest

创建 MCP Server 项目

在命令行运行下面命令，创建 MCP Server 项目：

yo mcp -n 'Weather MCP Server'

实现代码逻辑

主要的代码逻辑在 src\streamableHttp.ts 文件中，可以不做修改直接使用。

启动项目

在命令行运行下面命令，启动 MCP Server 项目：

npm run build
npm run start:streamableHttp

在 VS Code 运行

安装好最新的 VS Code Insiders 版本。

打开 .vscode\mcp.json，取消 weather-mcp-server-streamable-http 的注释，点击 “start” 按钮：

现在，就能在 VS Code Insiders 的 Agent Mode 调用你的 MCP Server 啦！

 

大功告成！

我的两个 MCP 项目完全开源，欢迎来围观或者一起共谋大业：

GitHub - formulahendry/generator-mcp: Yeoman Generator to quickly create a new MCP Server

GitHub - formulahendry/mcp-server-code-runner: Code Runner MCP Server

 

原创作者: formulahendry 转载于: https://www.cnblogs.com/formulahendry/p/18837144
泉川
关注
MCP通信方式之Streamable HTTP
寻梦友的博客
06-05 1097
Streamable HTTP 是 MCP 协议的新标准，解决了 HTTP SSE 的连接不可恢复、长连接资源消耗等问题，同时保留流式响应优势。它采用普通 HTTP 请求为基础，灵活升级为 SSE 流，去中心化且无强制长连接要求。相比 SSE，Streamable HTTP 具有更好的稳定性、性能和客户端实现简易性。其核心设计通过请求 ID 记录实现断线重连，按需保持连接，并兼容现有基础设施。演示案例展示了如何通过 Streamable HTTP 实现天气查询和 ES 搜索的智能调用。
cherry使用MCP协议Streamable HTTP实践
最新发布
AI拉呱，专注于人工智与网络安全方面的研究，关注一起学习。
07-17 162
摘要：Streamable HTTP协议是针对传统HTTP+SSE传输方式的改进方案，解决了连接恢复、服务器资源占用和单向通信等问题。该协议基于普通HTTP实现，支持无状态服务器、纯HTTP服务和多轮对话，同时兼容现有基础设施。通过演示展示了服务端和客户端的配置方法，体现了其灵活性和实用性。MCP（多轮对话协议）作为扩展LLM能力的关键技术，代表着未来交互式AI的发展趋势。
MCP协议Streamable HTTP
weixin_28760171的博客
04-25 486
2025 年 3 月 26 日，模型上下文协议（Model Context Protocol，简称 MCP）引入了一项关键更新：用 Streamable HTTP 替代原先的 HTTP + SSE 作为默认传输方式。这一变更在解决原有方案中连接不可恢复、服务端长连接压力大等问题的同时，依然保留了 SSE 带来的流式响应优势。
MCP Server StreamableHTTP 开发学习文档
青蛙博客
05-22 1534
MCP Server StreamableHTTP 开发学习文档介绍了基于 HTTP 的流式通信传输方式 StreamableHTTP 的核心功能与实现。StreamableHTTP 支持服务端向客户端持续推送事件，并具备断线重连恢复能力，适用于实时通知、长连接事件流等场景。文档详细解析了源码结构，包括入口配置、工具注册与调用、事件存储与可恢复性、Session 管理与 ASGI 集成等关键实现。此外，文档还介绍了 SSE（Server-Sent Events）机制及其在示例中的应用，并提供了本地部署与运行
再见，SSE！你好，Streamable HTTP！
HJ说
04-20 593
如果我当年本科的暑假大作业，还有一天就要deadline了，我也许才会选择这两个协议，能让我快速出活。SSE 的运行在 remote 的 MCP Server 来说，就需要保证高可靠性。SSE 需要 server 端保持一个长连接，而且，根据 MCP 的协议，在 MCP Client 与。MCP Server 建立 SEE 连接后，在整个 connection 的生命周期中，MCP Server 的开发者来说，真是一个极好的消息，因为在不少场景中，在 3 月 26 日，MCP 发布了最新的 spec，用。
MCP协议的Streamable HTTP：革新数据传输的未来
蜗牛沐雨
04-01 2890
在数字化时代，数据传输的效率和稳定性是推动技术进步的关键。MCP（Model Context Protocol）作为AI生态系统中的重要一环，通过引入Streamable HTTP传输机制，为数据交互带来了革命性的变化。本文将深入解读MCP协议的Streamable HTTP，从会话协商到正式通信传输数据的全过程，探讨其技术架构、协议内容、实现方式以及对AI应用的影响。Streamable HTTP作为MCP协议的一项重大更新，旨在解决传统HTTP+SSE方案的局限性，同时保留其优势。
MCP 协议 Streamable HTTP：破局传统 HTTP+SSE 局限的流式传输方案
百态老人的博客
06-13 947
MCP通过Streamable HTTP实现了HTTP模式下的高效流式传输，其核心价值在于。
MCP Streamable HTTP 传输层的深度解析及实战分析
AllenLV的博客
05-11 1612
Streamable HTTP 传输层设计通过整合 HTTP/1.1、HTTP/2 和 SSE 协议，实现了动态协议协商、流式优先传输和智能背压控制。相较于传统的 HTTP+SSE 方案，Streamable HTTP 具备多路复用、流级流量控制等优势，支持更高效的半双工通信。其架构分为应用层、传输层和协议层，支持 JSON 事件和二进制帧的灵活处理。在 Spring AI Alibaba 实现中，通过 StreamableRequestAdapter 和 StreamableResponseWriter
基于 FastMCP 框架的 Streamable HTTP MCP 应用开发实践
qq_33933889的博客
05-15 1085
随着 Python 开发生态的持续演进，FastMCP 框架在 2025 年 5 月 9 日发布的 v2.3.0 版本中，正式引入了对 Streamable HTTP 协议的原生支持。这一更新标志着 MCP（Multi-Channel Protocol）应用开发进入了更高效的流式通信阶段。尽管早期版本存在部分缺陷，但通过pip install --upgrade fastmcp升级至最新版本后，稳定性得到显著提升。
实现一个支持 Streamable HTTP 的 MCP 服务器及客户端
蜗牛沐雨
03-31 4180
在现代的 Web 开发中，实时数据传输是一个常见的需求。本文将介绍如何使用 FastAPI 实现一个支持 Streamable HTTP 的 MCP（Model Context Protocol）服务器，并提供 Python 客户端和前端客户端的实现。Streamable HTTP 是一种允许服务器以流的形式向客户端发送数据的技术。这在处理长时间运行的操作或实时数据更新时非常有用。MCP（Model Context Protocol） 是一种协议，用于在客户端和服务器之间传输模型上下文信息。
MCP 实践（二）传输机制（Streamable HTTP）
cliffordl的专栏
07-03 1332
HTTP + SSE 存在的问题 和 Streamable HTTP 的改进： https://developer.aliyun.com/article/1661971HTTP+SSE 的传输过程实现中，客户端和服务器通过两个主要渠道进行通信：（1）HTTP 请求/响应：客户端通过标准的 HTTP 请求向服务器发送消息。（2）服务器发送事件（SSE）：服务器通过专门的 /sse 端点向客户端推送消息，这就导致存在下面三个问题： • 服务器必须维护长连接，在高并发情况下会导致显著的资源消耗。 • 服务器消息只
SSE与Streamable HTTP的区别：协议与技术实现的深度对比
04-02 3660
Server-Sent Events（SSE）是一种基于HTTP协议的单向通信协议，它允许服务器以事件流（Event Stream）的形式实时向客户端推送数据，而无需客户端明确请求[0SSE是HTML5规范中定义的一种技术，它为服务器向客户端的实时通信提供了一个简单而高效的方式。SSE基于HTTP协议，目前除了IE/Edge，其他主流浏览器都支持这一技术[1SSE的主要特点是允许服务器主动推送数据，而无需客户端不断轮询服务器。
MCP协议重大升级，Spring AI Alibaba联合Higress发布业界首个Streamable HTTP实现方案
阿里巴巴云原生的博客
04-23 2360
MCP 官方引入了全新的 Streamable HTTP 传输层，对原有 HTTP+SSE 传输机制有重大改进。
SpringBoot改造MCP服务器（StreamableHTTP 类型）
kylewka
04-29 2592
本文介绍了SpringBoot如何实现MCP StreamableHTTP 服务器，并且使用 Cherry Studio 客户端测试MCP服务器。
大模型MCP更高效的通信：StreamableHTTP协议
zhangzhentiyes的博客
05-10 1831
Model Context Protocol (MCP) 引入了新的 StreamableHTTP 通信协议，以提升模型服务器与客户端之间的通信效率和灵活性。StreamableHTTP 基于 HTTP/1.1 或 HTTP/2，支持双向流式数据传输，适用于分布式和云原生环境。相比传统 stdio 和 Server-Sent Events (SSE)，StreamableHTTP 具有 Web 友好性、标准化、双向流处理、持久连接和元数据处理等优势，成为 MCP 在分布...
python开发Streamable HTTP MCP应用
shykevin的博客
05-15 1253
2025 年 5 月 9 日，fastmcp发布v2.3.0版本，正式支持Streamable HTTP终于等到官方支持了！注意：2.3.0版本有bug，目前最新版本已经修复了升级到最新版本这里就不再重复了。
mcp server streamable http
06-17
<think>我们正在讨论MCP服务器（可能是某种自定义服务器）的流式HTTP处理。根据用户提供的引用，我们看到一个HTTPPOST请求示例，该请求发送到`/messages/`端点，并且服务器返回了202Accepted状态码。但是，用户现在关心的是流式处理（streamableHTTP）的配置或实现。在HTTP中，流式处理通常意味着服务器能够逐步发送响应（例如使用分块传输编码）或者客户端能够发送流式请求（例如上传大文件时边读边传）。在MCP服务器的上下文中，用户可能希望实现或配置类似的功能。根据引用中的示例，我们注意到：-请求是一个完整的POST请求，不是流式上传。-响应是202Accepted，并且响应体很小（只有8字节），这显然不是流式响应。因此，我们需要考虑如何将MCP服务器配置为支持流式处理。###可能的流式处理场景1.**流式响应（Server-SentEvents,WebSocket,或分块传输编码）**：服务器可以分块发送数据，例如实时更新。2.**流式请求**：客户端可以分块上传数据，服务器边接收边处理。###配置或实现建议####1.使用分块传输编码（ChunkedTransferEncoding）在HTTP/1.1中，分块传输编码允许服务器将响应分成多个部分（块）发送。这通常用于当响应内容长度未知时，或者需要实时生成内容时。在Python中，如果你使用像uvicorn这样的ASGI服务器（如引用中所示），并且你的应用是异步的（例如基于Starlette或FastAPI），你可以返回一个生成器来实现流式响应。示例（FastAPI）：```pythonfromfastapiimportFastAPIimportasyncioapp=FastAPI()@app.post("/stream_response/")asyncdefstream_response():asyncdefgenerate():foriinrange(5):awaitasyncio.sleep(1)yieldf"Chunk{i}\n"returnStreamingResponse(generate(),media_type="text/plain")```####2.流式请求对于流式请求，客户端可以分块发送数据。服务器需要能够逐步读取请求体。在FastAPI中，你可以使用`Request`对象直接读取请求体流：```pythonfromfastapiimportFastAPI,Requestapp=FastAPI()@app.post("/stream_request/")asyncdefstream_request(request:Request):#逐块读取请求体asyncforchunkinrequest.stream():#处理每个块process_chunk(chunk)```####3.使用WebSocket如果需要双向流式通信，WebSocket可能是更好的选择。但WebSocket是完全不同的协议，不是HTTP。####4.服务器配置在引用中，服务器是uvicorn。uvicorn支持流式响应和请求，但需要应用程序支持（如上例所示）。因此，配置主要在应用程序代码中实现，而不是在服务器配置文件中。###针对MCP服务器的建议由于用户提到的MCP服务器（可能是自定义服务器）已经使用了uvicorn，因此可以按照上述方式实现流式处理。但是，具体到MCP服务器的实现，我们需要知道它的内部架构。如果MCP服务器是基于类似FastAPI的框架，那么实现流式处理是直接的。如果MCP服务器是用户自己开发的，那么需要：-对于流式响应：在生成响应时，使用分块传输编码。在ASGI中，可以通过返回一个异步生成器来实现。-对于流式请求：在读取请求体时，不要一次性读取，而是逐块读取（通过`request.stream()`）。###注意事项-在HTTP/1.1中，分块传输编码是标准的一部分，但客户端必须支持。-在HTTP/2中，流式处理更加高效，因为它支持多路复用。###引用说明引用[1]中展示的MCP服务器当前的处理方式是非流式的（一次性请求，一次性响应）。因此，要实现流式处理，需要修改端点处理逻辑。§§相关问题§§1.如何测试MCP服务器的流式HTTP端点？2.在流式处理中，如何处理错误和中断？3.MCP服务器支持HTTP/2吗？如何配置？</think>### MCP服务器流式HTTP处理分析 根据您提供的引用信息和需求，MCP服务器的流式HTTP处理涉及以下关键点： 1. **现有通信模式分析** 引用[1]显示当前MCP SSE服务器使用标准HTTP短连接POST请求： ```http POST /messages/?session_id=97a44bcff590415e99cf803350ffd542 HTTP/1.1 Host: 10.0.105.64:8080 Content-Type: application/json {"method":"tools/call","params":{...}} ``` 服务器返回`202 Accepted`状态码，表明请求已被接受但处理未完成[^1]。这种模式**不满足流式处理需求**，因为： - 使用短连接而非持久连接 - 响应为完整一次性返回 - 缺少流式数据传输机制 2. **流式HTTP实现方案** 要实现流式处理，建议采用以下技术： **a) 分块传输编码（Chunked Transfer Encoding）** 在HTTP响应头中添加： ```http HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/x-ndjson ``` 服务器分段发送数据： ```http 1A // 十六进制块大小 {"event":"update","data":"..."} 0 // 结束块 ``` **b) Server-Sent Events（SSE）** 专为服务器到客户端的单向流设计： ```python # FastAPI示例 @app.get("/stream") async def message_stream(): async def event_generator(): while True: if new_data := await queue.get(): yield f"data: {json.dumps(new_data)}\n\n" return EventSourceResponse(event_generator()) ``` 客户端通过`EventSource` API接收： ```javascript const source = new EventSource('/stream'); source.onmessage = (event) => { ... }; ``` **c) WebSocket双向流** 适用于双向实时通信： ```python # uvicorn+WebSockets实现 @app.websocket("/ws") async def websocket_endpoint(websocket: WebSocket): await websocket.accept() while True: data = await websocket.receive_text() # 处理并流式返回 await websocket.send_text(process(data)) ``` 3. **MCP服务器配置建议** - **协议升级**：在现有POST端点添加`Accept: text/event-stream`支持 - **会话保持**：利用现有`session_id`参数维持流连接 - **超时设置**：配置`keepalive_timeout`保持长连接 - **缓冲区管理**：调整`uvicorn`的`max_queued_bytes`防止背压 4. **性能优化方向** - 使用异步框架（如Starlette）处理高并发流 - 实施背压控制（backpressure control） - 添加`Last-Event-ID`头支持断线重连 - 压缩流数据：`Content-Encoding: gzip` > **关键区别**：传统HTTP请求（如引用所示）是事务型交互，而流式HTTP建立持久通道持续传输数据片段[^1]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值