MCP TypeScript SDK

它做什么

• MCP 官方 TypeScript/JavaScript SDK，modelcontextprotocol 组织维护，用于构建客户端与服务端
• 高层 McpServer API + 底层 Server/Client，需要完整协议控制时用后者
• 基于 Zod 定义工具与资源 schema，输入输出全程类型化
• 传输层：stdio、Streamable HTTP、SSE（遗留）——换传输不动 handler 代码
• 大多数生产级 TypeScript MCP server 的底座

什么时候用

用 TypeScript 自建 MCP server 的起点，也是给应用嵌入 MCP 能力的客户端方案。开发期配 MCP Inspector 调试。

如何上手

npm install @modelcontextprotocol/sdk
# 需要 Node 18+。最小 server：

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({ name: "my-server", version: "1.0.0" });
// 注册 tools、resources、prompts...
await server.connect(new StdioServerTransport());

注意事项

协议版本迭代快——pin 住 SDK 版本，客户端握手失败时先查 spec changelog。ESM 优先：CommonJS 项目容易踩 import 路径坑。高层 API 覆盖常见场景；冷门传输很快会逼你用底层 API。