MCP 我用得不算少,配过十来个 server,也把自家工具包成过 MCP 服务给 Claude 挂载。但要说协议底下到底有什么,我说不上来——SDK 封装得太顺手,配一个 server 就是往 JSON 里填几行命令,出了问题基本靠重启解决。
前几天翻官方规范,想搞清楚 initialize 握手里 capability 协商的细节,结果撞上一个大变化:今年7月底定稿的 2026-07-28 修订版,把握手整个删了。而就在我翻规范的这几天,掘金热榜上还有一篇把 MCP 首屏报文拆开讲的文章,开头正是那套三步握手——客户端先问服务器支持什么,服务器回应,再发一条 initialized 通知。那是旧版流程,规范里现在管它叫 legacy,2025-11-25 及更早的版本都算。这事可以直接上规范站核对:modelcontextprotocol.io 的版本列表里,2026-07-28 排在最前,旧版页面(比如 2025-06-18)顶部到现在还挂着"你正在看旧版本,最新版是 2026-07-28"的跳转横幅。
于是起了手写的念头:不装 SDK,只用 Python 标准库,照最新规范把客户端和服务端各写一个最小的,看协议底下到底还剩什么。写完的感受先放这——薄得超出预期,而且比网上教程描述的开放得多。
规范里已经没有握手了
先把变化说清楚。旧流程里,连上服务器要先走三步:initialize 请求带上自己支持的协议版本和能力,服务器回应自己这边的情况,客户端再补一条 notifications/initialized,会话才算建立,之后才许发 tools/list 这类业务请求。
2026-07-28 修订版把这套全删了。规范原文的表述是:协议是无状态的,处理请求需要的所有信息都在请求自己身上,服务器不许从同一条连接上前面的请求推断任何上下文(原文见 modelcontextprotocol.io/specification/2026-07-28/basic/lifecycle)。协议版本、客户端身份、能力声明,全部塞进每个请求的 _meta 字段:
"params": {
"name": "word_count",
"arguments": { "text": "..." },
"_meta": {
"io.modelcontextprotocol/protocolVersion": "2026-07-28",
"io.modelcontextprotocol/clientCapabilities": {},
"io.modelcontextprotocol/clientInfo": { "name": "handroll-client", "version": "0.1.0" }
}
}
_meta 里有两个键必填:protocolVersion 和 clientCapabilities,缺了服务器必须回 -32602。版本号服务器不支持,回新定义的 -32022,并在 data 里列出自己支持的版本,客户端挑一个重发就是。原来握手干的活,拆到了每个请求头上。
能力声明的粒度也跟着变了。旧版在握手时一次性声明"这个会话里我打算用哪些能力",新版每个请求都自带——服务器对某个方法有硬性能力要求时,就直接看这个请求头上的声明,不够就回 -32021,data 里指名要哪几项。不光版本协商降级成了请求属性,能力协商也是。
配套还多了个 server/discover 方法:规范要求服务器必须实现,客户端可以在发业务请求前先问一句"你支持哪些版本、有哪些能力",也可以不问,直接发请求撞错误码再说。
另一个我完全没想到的变化:旧版里服务器可以主动向客户端发起请求,比如 sampling,让客户端替它调一次大模型。新版明令禁止——stdio 传输下,服务器不许向 stdout 写任何 JSON-RPC 请求。它想反过来要东西,只能在响应的 result 里带"还需要输入"的标记,由客户端发起下一轮。规范管这套叫 Multi Round-Trip Requests,算是一次不小的架构转向。
错误码也重新划了段(划分见 basic/versioning 一章)。JSON-RPC 约定里 -32000 到 -32099 本是各实现的自定义区,现在 MCP 把 -32020 到 -32099 收归规范保留:-32020 HeaderMismatch、-32021 缺客户端能力、-32022 版本不支持;剩下的 -32000 到 -32019 继续留给实现。
服务端:几十行的事
服务端的主循环长这样,完整代码七十多行:
for line in sys.stdin:
msg = json.loads(line)
meta = (msg.get("params") or {}).get("_meta") or {}
if META_PROTO not in meta or META_CAPS not in meta: # 必填项缺失
write(error(mid, -32602, "missing required _meta fields"))
continue
if meta[META_PROTO] not in SUPPORTED: # 版本不支持:附上自己支持的版本让客户端重挑
write(error(mid, -32022, "Unsupported protocol version",
{"supported": SUPPORTED, "requested": meta[META_PROTO]}))
continue
if msg["method"] == "server/discover":
write(result(mid, {"resultType": "complete",
"supportedVersions": SUPPORTED,
"capabilities": {"tools": {}},
"_meta": {META_SRV: {"name": "wordcount-server", "version": "0.1.0"}}}))
elif msg["method"] == "tools/list":
write(result(mid, {"resultType": "complete", "tools": TOOLS}))
elif msg["method"] == "tools/call":
text = (msg["params"].get("arguments") or {}).get("text", "")
words = len([w for w in text.split() if w])
out = f"字符数: {len(text)}\n单词数: {words}\n行数: {len(text.splitlines())}"
write(result(mid, {"resultType": "complete",
"content": [{"type": "text", "text": out}],
"isError": False}))
else:
write(error(mid, -32601, f"Method not found: {msg['method']}"))
有两个细节是规范硬性要求,写的时候容易漏。一是 stdout 只能出 MCP 报文,我的日志全走了 stderr;二是新版所有响应的 result 必须带 resultType 字段,"complete" 表示正常完成——这是给多轮请求留的位子,服务器要是需要客户端补充输入,就回一个 "input_required",而不是像旧版那样自己发请求。 工具本体我做得极简,一个 word_count 数字符数,让 tools/call 有东西可调。
客户端与第一轮报文
客户端要做的更少:起子进程、拼 _meta、逐行读写。核心就是一个 meta 构造函数:
def meta(version="2026-07-28"):
return {
"io.modelcontextprotocol/protocolVersion": version,
"io.modelcontextprotocol/clientInfo": {"name": "handroll-client", "version": "0.1.0"},
"io.modelcontextprotocol/clientCapabilities": {},
}
跑通的第一组真实报文,server/discover 的问与答:
C->S {"jsonrpc": "2.0", "id": 1, "method": "server/discover", "params": {"_meta": {"io.modelcontextprotocol/protocolVersion": "2026-07-28", "io.modelcontextprotocol/clientInfo": {"name": "handroll-client", "version": "0.1.0"}, "io.modelcontextprotocol/clientCapabilities": {}}}}
S->C {"jsonrpc": "2.0", "id": 1, "result": {"resultType": "complete", "supportedVersions": ["2026-07-28"], "capabilities": {"tools": {}}, "_meta": {"io.modelcontextprotocol/serverInfo": {"name": "wordcount-server", "version": "0.1.0"}}}}
接着 tools/call 调一次真的:
C->S {"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "word_count", "arguments": {"text": "把 MCP 拆开看,底下其实就是一层 JSON-RPC。"}, "_meta": { ...同上,略... }}}
S->C {"jsonrpc": "2.0", "id": 4, "result": {"resultType": "complete", "content": [{"type": "text", "text": "字符数: 28\n单词数: 4\n行数: 1"}], "isError": false}}
没有握手,没有会话,请求发出去结果就回来。说实话写到这里我有点恍惚——折腾了半天,MCP 就是"每行一个 JSON-RPC,外加一条强制自报家门的 _meta"。
故意弄坏三个请求
跑通不算验证,我挑了三个最容易踩的路径,故意发坏请求,看服务器反应是否和规范写的一致。 第一个最关键:客户端声明一个 legacy 版本号 2025-06-18,服务器怎么回?
C->S {"jsonrpc": "2.0", "id": 5, "method": "tools/list", "params": {"_meta": {"io.modelcontextprotocol/protocolVersion": "2025-06-18", ...}}}
S->C {"jsonrpc": "2.0", "id": 5, "error": {"code": -32022, "message": "Unsupported protocol version", "data": {"supported": ["2026-07-28"], "requested": "2025-06-18"}}}
-32022 如约而至,data 里的 supported 数组直接告诉你下一步怎么办:挑一个它认的版本重发。第二个坏请求紧跟着这个失败发出去:换回 2026-07-28 再发一个 tools/call,直接就成功了——中间没有任何"恢复会话"的动作。写惯了有会话协议的人,这个瞬间会有点不适应:失败的请求就是个普通失败,不会留下需要清理的状态。顺带还发现一个调试上很实用的性质:同一个连接里可以反复换版本号试探,观察每个请求各自的反应,不用担心上一发污染下一发。 第三个坏请求专试 _meta 的必填项,把 clientCapabilities 漏掉,服务器秒回 -32602:
S->C {"jsonrpc": "2.0", "id": 7, "error": {"code": -32602, "message": "Invalid params: missing required _meta fields (io.modelcontextprotocol/protocolVersion, io.modelcontextprotocol/clientCapabilities)"}}
三条路径,全落在规范写死的错误码上。这里有个容易混淆的点:-32602 是 JSON-RPC 的通用参数错误,而 -32022 这类 -32020 段的错误码才是 MCP 自己定义的协议级错误——规范靠这个区别做新旧时代的判断,下一节就用到。
接上旧服务器
规范没有一刀切,它给新旧两套协议设计了一条兼容路径:客户端先发 server/discover 探测,收到 DiscoverResult 或者 -32022 这类"认得出的 modern 错误",说明对面是新服务器;收到别的错误或者压根不应答,就当它是 legacy,回退 initialize 握手。 我把前面那个旧流程的服务器也写了一个最小版,用同一个客户端去连:
C->S {"jsonrpc": "2.0", "id": 1, "method": "server/discover", "params": {"_meta": { ...modern _meta... }}}
S->C {"jsonrpc": "2.0", "id": 1, "error": {"code": -32602, "message": "not initialized"}}
C->S {"jsonrpc": "2.0", "id": 2, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "handroll-client", "version": "0.1.0"}}}
S->C {"jsonrpc": "2.0", "id": 2, "result": {"protocolVersion": "2025-06-18", "capabilities": {"tools": {}}, "serverInfo": {"name": "wordcount-server-legacy", "version": "0.1.0"}}}
C->S {"jsonrpc": "2.0", "method": "notifications/initialized"}
旧服务器的 initialize 被拒了 server/discover 之后照常接上了,后续 tools/list、tools/call 全部正常。有个细节很有意思:legacy 服务器的 tools/list 返回里没有 resultType 字段,规范替它想好了——客户端必须把缺失的 resultType 当作 "complete" 处理。新旧两套在这类细节上咬合得很紧,看得出来是认真设计过的,不是拍脑袋删功能。
写完之后的想法
一个客户端加两个服务端,加上报文记录二百五十来行,没有一行超出标准库。最直观的结论:MCP 的协议本体薄得惊人,SDK 里那几万行代码,封装的是重连、OAuth、schema 校验、订阅这些工程问题,不是协议复杂度。
握手被删掉这件事,我现在的理解是:它把"版本兼容"从会话属性降级成了请求属性。旧版你要搞清楚当前会话协商到了哪个版本、能力开了哪些;新版每个请求自带这些信息,服务器无状态处理,坏请求直接换一个版本号重发。代价是报文变长、每个请求都重复背一份元数据——这笔账在 HTTP 世界里早就被接受过一次,MCP 只是跟进了。
要是你也配过一堆 MCP server,我的建议是别猜:调试时把 stderr 打开、把报文抓出来看,协议小到肉眼可读,比翻 SDK 源码快得多。官方 TypeScript SDK 的 v1 维护线最新是 1.32.2,但它只实现到 2025-11-25 旧规范;2026-07-28 的支持在 v2 里,拆成了 @modelcontextprotocol/server 和 @modelcontextprotocol/client 两个独立包。封装照用没问题;只是这次手写完,再去看 SDK 源码就不发怵了——底下每条消息长什么样,我都在报文里见过真身。