🐘 巨象 AI 前沿雷达 🪐 巨象在火星 · MARS OUTPOST← 返回巨象雷达主站
Dev.to2026-11-05 17:16AI 生成

升级了 MCP 新 SDK,服务器却只认老客户端?升级包版本根本没用!MCP 官方 SDK v2 把会话和握手全砍了,老代码直接失联

官方 TypeScript SDK v2 实现 2026-07-28 版 MCP 规范,砍掉会话与 initialize 握手,只改版本号不改代码的服务器会只认老客户端。

大白话如果你在 Node.js 里搭过 MCP 服务器,网上教程大多还在教 v1 的写法,现在这套已经落后了。官方 TypeScript SDK v2 是稳定版,对应 2026-07-28 版 MCP 规范,改动挺大:协议层会话和 Mcp-Session-Id 头没了,initialize 握手也没了,每个请求自己带版本和能力信息,更新推送统一走 subscriptions/listen。SDK 也被拆成 server、client 和 node 适配器等几个包,要求 Node.js 20 以上、Zod 4,原来的 server.tool() 换成 registerTool()。最坑的是:光升级包版本,服务器还是只会说老协议。
对你意味着正在写或维护 MCP 服务器的开发者必看,尤其是准备接 Claude 的人;不换 handler,新老客户端可能两头不讨好。

原文:MCP Server in Node.js: What the v2 TypeScript SDK Changes

打开巨象雷达,看今天全部 AI 动态