MCP Streamable HTTP 是什么？

流式HTTP传输 —— MCP 协议的新一代传输层，告别 SSE，拥抱无状态化

🎯 为什么需要 Streamable HTTP？

旧的 MCP 传输方式存在几个问题：

• 🔹 SSE 需要长连接：服务器必须维持连接状态，扩展性差
• 🔹 Session ID 依赖：客户端和服务器需要维护会话状态
• 🔹 负载均衡困难：有状态连接难以在多实例间分配
• 🔹 Serverless 不友好：AWS Lambda 等无服务器平台无法维持长连接

⚡ Streamable HTTP vs SSE

特性	SSE (旧)	Streamable HTTP (新)
连接模型	长连接、有状态	短连接、无状态
Session ID	必须	移除
负载均衡	困难（粘性会话）	简单（无状态）
Serverless 支持	❌ 不支持	✅ 完美支持
扩展性	受限于连接数	水平扩展无限制
断线重连	需要特殊处理	天然支持（无状态）

🔧 核心机制

1. 请求-响应模型

// Streamable HTTP 请求示例
POST /mcp HTTP/1.1
Content-Type: application/json
Accept: application/json, text/event-stream
Mcp-Method: tools/call
Mcp-Name: web_search

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "web_search",
    "arguments": { "query": "OpenClaw latest" }
  },
  "id": "req_123"
}

2. 流式响应

// 流式响应（text/event-stream）
HTTP/1.1 200 OK
Content-Type: text/event-stream

data: {"jsonrpc":"2.0","result":{"type":"progress","message":"Searching..."},"id":"req_123"}

data: {"jsonrpc":"2.0","result":{"type":"result","content":[...]},"id":"req_123"}

data: [DONE]

3. 新增 Header

Header	说明	示例
Mcp-Method	调用的 MCP 方法名	tools/call
Mcp-Name	工具/资源名称	web_search
Accept	支持的响应格式	application/json, text/event-stream

🔧 OpenClaw 中的 Streamable HTTP

// openclaw.config.ts - MCP 服务器配置
{
  "mcp": {
    "servers": {
      "my-server": {
        "url": "https://mcp.example.com/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer ${MCP_TOKEN}"
        }
      }
    }
  }
}

⚠️ 迁移注意事项

🔗 相关概念