用途：在 MCP 服务端 SDK v2 alpha（拆分为 @modelcontextprotocol/server、/client、/core 及 /node、/express、/hono 适配器）上构建或维护 MCP 服务。资料标注 2026-05-09 时最新 npm 标签为 2.0.0-alpha.2，属预发布；多数生产服务建议留在 v1.x，采用前需固定精确版本并准备回滚。
主要能力与规则：使用 @modelcontextprotocol/server 的 McpServer，不再直接使用低层 Server；用 registerTool/registerResource/registerPrompt 注册，v2 已移除位置参数重载；schema 使用完整 zod/v4 的 z.object({...})；HTTP 传输从 @modelcontextprotocol/node 导入 NodeStreamableHTTPServerTransport，SSEServerTransport 已移除；Express/Hono 使用官方适配器 createMcpExpressApp()/createMcpHonoApp()。仅支持 ESM，需 Node.js 20+、TypeScript 5+。处理器签名为 (args, ctx)，通过 ctx.mcpReq.signal/log()/notify()/elicitInput()/requestSampling() 与 ctx.http?.authInfo 访问上下文；服务端 OAuth 已从 SDK 移除，需在 HTTP 层接入并把认证信息传入 ctx.http?.authInfo。
使用方式：先检测 package.json 与源码判断是 v2 还是 v1（v1 用 build-mcp-server-sdk-v1，迁移用 convert-mcp-sdk-v1-to-v2）。安装示例：npm install --save-exact @modelcontextprotocol/server@2.0.0-alpha.2、npm install zod@^4，HTTP 再加 @modelcontextprotocol/node@2.0.0-alpha.2。构建顺序：构造 McpServer → 定义 schema → registerTool → 按需注册资源与提示 → 构造传输并 connect → 处理优雅关闭。
验证与限制：可先构建与测试，stdio 用 npx @anthropic-ai/mcp-inspector，HTTP 用 curl 或 Inspector 探测；校验无效输入应返回 isError: true。限制：alpha 版本间可能不兼容，勿用 ^ 范围；@modelcontextprotocol/sdk 仍为 v1；server-auth-legacy 属计划中，发布状态暂未提供；各 MCP 主机端到端支持情况暂未提供。