MCP协议Streamable HTTP

# 一、概述 2025 年 3 月 26 日，模型上下文协议（Model Context Protocol，简称 MCP）引入了一项关键更新：用 Streamable HTTP 替代原先的 HTTP + SSE 作为默认传输方式。 这一变更在解决原有方案中连接不可恢复、服务端长连接压力大等问题的同时，依然保留了 SSE 带来的流式响应优势。 ## HTTP + SSE 的缺陷 远程 `MCP` 通过 `HTTP + SSE` 的传输方式工作，存在以下问题，这也是它所被替换的根本原因： - 不支持恢复连接 - 要求服务器保持高可用的长连接 - 服务器只能通过 `SSE` 发送消息 ### 不支持恢复连接 如果客户端和服务器之间的 `SSE` 连接中断了，就无法 “从端点继续”，只能重新开始新的连接，之前的上下文可能会丢失。 ### 要求服务器保持高可用的长连接 服务器必须一直保持一个稳定、不中断的 `SSE` 长连接，否则通信就中断。 ### 服务器只能通过 `SSE` 发送消息 服务器无法在已有的请求之外，主动地发送消息给客户端，除了通过专门的 /sse 通道。换句话说，它是“单向被动响应”，而不是“任意时机推送”。 # 二、Streamable HTTP `Streamable HTTP` 并不是传统意义上的 **流式 HTTP**（`Streaming HTTP`），它指的是一种 **兼具以下特性的传输机制**： - 以普通 `HTTP` 请求为基础，客户端用 `POST/GET` 发请求； - 服务器可选地将响应升级为 `SSE` 流，实现 **流式传输** 的能力（当需要时）； - 去中心化、无强制要求持续连接，支持 `stateless` 模式； - 客户端和服务端之间的消息传输更加灵活，比如同一个 `/message` 端点可用于发起请求和接收 `SSE` 流； - 不再需要单独的 `/sse` 端点，一切通过统一的 `/message` 协议层处理。 ## Streamable HTTP 的优势 - 支持无状态服务器：无需维持高可用的长连接 - 纯 `HTTP` 实现：`MCP` 可在纯 `HTTP` 服务中实现，无需 `SSE` 支持 - 兼容基础设施：因为 “只是 HTTP”，可以与中间件和现有基础设施良好集成 - 向后兼容：是当前 `HTTP+SSE` 传输方式的渐进式改进 - 灵活的传输方式：服务器可选择是否使用 `SSE` 进行流式响应 ## 从 HTTP+SSE 到 Streamable HTTP 的变化 - 移除了 `/sse` 端点 - 所有客户端 → 服务端的消息都通过 `/message`（或类似端点）发送 - 所有客户端 → 服务端的请求都可以被服务器升级为 `SSE`，以发送通知或请求 - 服务器可以选择建立会话 `ID` 以维护状态 - 客户端可以通过对 `/message` 发送一个空的 `GET` 请求启动 `SSE` 流 - 该方法兼容旧版本的实现，并允许服务器保持无状态（如果有需要）  # 三、Streamable HTTP demo演示 目前我所了解到的，Java，Nodejs，这些都已经支持了Streamable HTTP。 之前用的fastmcp框架，目前不支持Streamable HTTP，但是官方表示，未来会支持，具体发布时间待定。 所以本文要演示Streamable HTTP，只能用Nodejs了，Java代码，我也不会。 ## mcp-server-code-runner mcp-server-code-runner是github里面的一个支持Streamable HTTP的项目，github地址：https://github.com/formulahendry/mcp-server-code-runner ### 安装 Node.js 从 https://nodejs.org/en 安装 LTS 版的 Node.js 即可。 ### 运行Streamable HTTP 从github上面下载代码之后，进入项目代码目录，运行以下命令即可 ```csharp npm install npm run build npm run start:streamableHttp ``` 执行之后，会输出： ```csharp > mcp-server-code-runner@0.1.6 start:streamableHttp > node dist/streamableHttp.js Code Runner MCP Streamable HTTP Server listening on port 3088 ``` 这里可以看到，监听端口是3088 ## Cherry Studio添加Streamable HTTP 请确保你的Cherry Studio客户端是最新版本，因为只有最新版本，才支持Streamable HTTP 下载地址：https://github.com/CherryHQ/cherry-studio/releases 目前最新版本是v1.2.7  安装完成后，点击MCP服务器 ## 添加MCP服务器 名称：streamable-http-mcp 类型：Streamable HTTP URL：http://localhost:3088/mcp  **注意：url后面是mcp，因为官方给的sdk，url后面就是mcp** **这里新增了请求头，如果你觉得MCP Server暴露在公网，任何人都可以接入MCP Server不安全，这里是可以做token校验的** **需要修改MCP Server里面的逻辑代码，建立请求之前，就校验token。如果是非法token，就返回401错误。** 保存成功后，点击工具 这里可以看到一个工具run-code  ## MCP测试 新建一个默认助手，在对话框，选择MCP设置，选择添加的MCP服务器，streamable-http-mcp   根据github项目提示，演示了3个问题，分别是： ```csharp Run the JavaScript Code: console.log(5+6) Where is temporary folder in my OS? Use run-code tool How many CPUs do I have in my machine? Use run-code tool ``` 转换为中文 ```csharp 运行JavaScript代码：console.log(5+6) 我的操作系统中的临时文件夹在哪里？使用运行代码工具 我的机器上有多少个CPU？使用运行代码工具 ``` 分别输入3个问题 ### 运行JavaScript代码：console.log(5+6)  答案是11，是正确的 ### 我的操作系统中的临时文件夹在哪里？使用运行代码工具  答案是，C:\Users\98733\AppData\Local\Temp，也是对的。 ### 我的机器上有多少个CPU？使用运行代码工具  打开任务管理，选择性能，右下角可以看到核心数   确实是8个，也是正确的。 网上找了一些文章，使用的python的，基本上都是通过FastAPI来实现的，但是测试下来，效果都不好。 有些代码运行没问题，但是Cherry Studio客户端添加会出现各种报错。 即使添加MCP服务器没报错，但是在聊天窗口调用MCP服务器还是会出现各种报错。 怎么办呢？目前也没有找到能正常使用的python框架，只能等待fastmcp官方更新吧，希望快一些。 本文参考链接： https://juejin.cn/post/7493404904725741603