用途：帮助使用 MCP SDK v2 拆分包构建或维护 MCP 服务器，覆盖拆分包导入、Zod v4、ServerContext、框架适配器等内容。该版本 2026 年 Q1 发布，社区采用仍较早。
主要能力：识别现有工程是 v2 还是 v1，选择新服务器实现分支，注册工具、资源与提示，配置 stdio 或 Streamable HTTP 传输，接入 Express 与 Hono 适配器，处理错误与优雅关闭。
必要用法：v2 使用 McpServer（Server 已弃用），用 registerTool / registerResource / registerPrompt，schema 必须是完整 z.object()，HTTP 使用 NodeStreamableHTTPServerTransport，处理函数第二参数为 ctx，通过 ctx.mcpReq.log() / signal / notify() 操作。安装示例：npm install @modelcontextprotocol/server zod；HTTP 加装 @modelcontextprotocol/node；Express 加装 @modelcontextprotocol/express express；Hono 加装 @modelcontextprotocol/hono hono。package.json 需 "type": "module"，TypeScript 5+ 配 "module": "Node16"、"moduleResolution": "Node16"。校验可用 npx @anthropic-ai/mcp-inspector npx tsx src/index.ts。
适用场景：新建 stdio 本地服务器、远程 Streamable HTTP 服务器、增加工具或资源提示、构建 MCP 客户端、部署到 Docker 或无服务器环境。
限制：仅 ESM，无 CommonJS；需 Node.js 20+；服务端 OAuth 已移除，改用 better-auth 等外部库；SSE 服务端传输已移除；不接受原始 Zod 形状；不要导入 @modelcontextprotocol/sdk；v2 社区示例和部分客户端支持尚少。若项目仍用单包 @modelcontextprotocol/sdk 或 (args, extra) 模式，应改用 v1 技能；使用 mcp-use 封装库则改用对应技能。