将Mcp stdio托管为SE / StreamableHTTP实现方案

📅 2026/8/6 3:29:22
将Mcp stdio托管为SE / StreamableHTTP实现方案
全部实现子进程 spawn桥接原有 stdio MCP 服务不用改原有 MCP 服务代码支持 SSE、新版 StreamableHTTPMCP 官方单端点 HTTP‑stream可以直接拿来做托管部署GitHub。1️⃣ supergateway最推荐社区活跃度最高Node.jsGitHubhttps://github.com/supercorp-ai/supergateway✅支持stdio → SSE/stdio → StreamableHTTP/stdio → WebSocket双向转换✅自动管理子进程生命周期消息帧处理Docker 支持直接 npx 一键运行✅支持多客户端连接会话管理符合 MCP 最新规范一行命令把你的 stdio MCP 暴露成StreamableHTTP新版官方推荐bash# 将本地stdio命令 mcp‑server 转为 StreamableHTTP监听8000端口 npx -y supergateway \ --stdio python your_mcp_server.py \ --outputTransport streamableHttp \ --port 8000访问端点POST http://127.0.0.1:8000/mcp输出 SSE 模式bashnpx -y supergateway --stdio python your_mcp_server.py --outputTransport sse --port 8000SSE 端点GET /sse消息 POST/messages适合快速原型、容器部署、企业托管测试生产注意增加鉴权API‑Key 中间件自己叠加。2️⃣ mcp‑proxyPython成熟桥接工具GitHubGitHub - sparfenyuk/mcp-proxy: A bridge between Streamable HTTP and stdio MCP transports · GitHub✅Python 实现支持双向stdio ↔ SSE / StreamableHTTP✅支持配置文件、docker‑compose 部署、会话管理安装bashpip install mcp-proxy注意这个项目有两个同名仓库认准knaou/mcp‑proxy另一款是 SSE→stdio客户端侧不要混淆。3️⃣ mcpgateRust单二进制网关企业级多后端GitHubhttps://github.com/mokeyish/mcpgate✅Rust编译单二进制无运行时依赖支持配置文件定义多个 stdio 后端 MCP 服务✅对外统一暴露 SSE / StreamableHTTP多客户端接入✅支持进程管理、健康检查、docker适合 K8s 部署通过config.json配置多个 stdio MCP 服务网关对外统一提供网络 transport。4️⃣ mcp‑stdio‑bridgePython生产向网关GitHubhttps://github.com/hackagadget/mcp-stdio-bridge✅YAML 配置、配置热重载、完整测试用例健壮的子进程管理、stderr 日志捕获✅仅做桥接任意 stdio 可执行 MCP → SSE支持 docker 镜像 amd64/arm64。5️⃣ IBM mcpgateway.translateIBM 官方开源工具文档https://ibm.github.io/mcp-context-forge/using/mcpgateway-translate/bashpython3 -m mcpgateway.translate \ --stdio uvx mcp‑server‑git \ --expose‑sse \ --port 9000IBM 出品协议兼容性很好适合企业调研。项目对比选型矩阵表格项目语言stdio→SSEstdio→StreamableHTTP打包方式适合场景supergatewayTS/Node.js✅✅npx / docker快速上线开发测试容器托管【首选】mcp‑proxyPython✅✅pip / dockerPython 栈技术栈团队mcpgateGo✅✅单二进制 /docker生产 K8s多 MCP 后端无依赖mcp‑stdio‑bridgePython✅部分支持docker追求稳定性配置热重载IBM mcpgateway.translatePython✅✅python 模块企业调研IBM 生态⚠️生产托管必须补齐开源 demo 都不带鉴权增加 Bearer Token / ApiKey HTTP header 校验绝对不要裸暴露公网。Nginx 反向代理配置nginxproxy_http_version 1.1; proxy_set_header Connection ; proxy_buffering off; #关闭缓冲SSE/stream http核心 chunked_transfer_encoding on;会话与进程策略supergateway 默认每客户端连接 spawn 一个子进程高并发要做进程池、空闲超时 kill 子进程防止进程爆炸。日志捕获子进程 stderr采集日志增加 prometheus 指标。两种部署模式代理网关模式上面所有开源项目不改原有 MCP 服务网关 spawn 子进程运行 stdio 服务对外 SSE/StreamableHTTP推荐用于存量 MCP 服务托管。源码直改 transport直接修改 MCP 服务代码去掉 StdioTransport使用 SDK 内置 SSEServerTransport / StreamableHttpServerTransport不需要子进程桥接适合你掌握源码的场景。客户端连接示例StreamableHTTP使用 MCP 官方 SDKtypescriptimport { StreamableHttpClientTransport } from modelcontextprotocol/sdk/client/streamableHttp.js; const transport new StreamableHttpClientTransport(new URL(http://127.0.0.1:8000/mcp)); await client.connect(transport);