远程 MCP:Streamable HTTP 绑定、无状态模型与请求元数据、OAuth 2.1 授权、容器部署
把服务端从本机子进程搬到公网:一个 POST 端点、两种响应形态、一套必填请求头,再配上 OAuth 2.1 的受众校验与一份能横向扩容的容器部署。
今日目标
- 能实现一个只有单个 POST 端点的 Streamable HTTP 服务端,并按需返回 JSON 或事件流
- 能说出这一版删掉了会话、GET 流与断流续传之后,客户端要怎么改
- 能解释 MCP 服务端作为受保护资源必须做的令牌受众校验,以及不做会怎样
前三天你的服务端都住在本机,被宿主当子进程拉起来,凭证从环境变量取,没人能从外面碰它。今天把它搬到公网——这一步会把「谁能连」「连上之后算谁的」「挂了怎么办」三个问题一次性推到你面前。读完回来把上面三条勾掉。
小白版讲解
从屋里现拉的线到接市政电网
stdio 是你在屋里现拉的一根线:两头都在你家,插头什么形状你自己说了算,没人会来蹭电。Streamable HTTP 是接市政电网:电压、频率、插座标准全得按公用规范来,因为线路那头是谁你不知道。
多出来的问题有四类,每一类都有对应的硬要求。
第一类是「谁在敲门」。 浏览器里的任意一个网页都能往 http://127.0.0.1:3034 发请求,这就是 DNS 重绑定攻击的入口:攻击者控制一个域名,让它先解析到自己的服务器骗过同源检查,再改解析到 127.0.0.1,于是你本机那个能读文件的 MCP 服务端就被一个陌生网页接管了。规范对此的要求是硬的:服务端必须校验 Origin 请求头,存在且非法时必须回 403。本机运行时还应该只绑回环地址 127.0.0.1,而不是 0.0.0.0——很多人在容器里习惯性写 0.0.0.0,然后把这个习惯带回了裸机。
第二类是「算谁的」。 stdio 下服务端天然只服务一个用户,公网上一个端点要面对成千上万个。规范说得很直白:所有连接都应该实现认证。具体做法在后面的 OAuth 那一节。
第三类是「有几个我」。 本机永远只有一个进程;公网上你会起三个五个副本,请求打到哪个都得能处理。这一条恰好是无状态协议最大的红利,最后一节会算这笔账。
第四类是「什么时候算完」。 本机调用几毫秒就回来了,公网上一个工具跑三十秒是常态,这期间连接空着,用户分不清它是在算还是已经死了。
第一类靠一行校验解决,剩下三类都得从传输层的形状说起。那这个端点具体长什么样?
面试题库
2026-07-28 去掉了协议级会话。那一个需要跨调用保存状态的远程服务端——比如购物车、数据库事务——应该怎么设计?The 2026-07-28 revision removed protocol-level sessions. How should a remote server that needs cross-call state — a shopping cart, a database transaction — be designed?
国内高频海外高频进阶#statelessness#api-design🔒 解锁本章后查看答题要点。
Streamable HTTP 要求 Mcp-Method 头必须和请求体里的 method 一致。为什么要抄一遍?不校验会有什么风险?Streamable HTTP requires the Mcp-Method header to match the method in the request body. Why mirror it at all, and what breaks if the server does not validate the match?
国内高频海外高频进阶#transport#security🔒 解锁本章后查看答题要点。
为什么 MCP 服务端绝对不能把客户端给的访问令牌直接转发给下游 API?Why must an MCP server never forward the client's access token straight to a downstream API?
国内高频海外高频深入#oauth#security🔒 解锁本章后查看答题要点。
