MCP TypeScript SDK（1.3万星）2026：用TypeScript构建你的第一个MCP服务器

MCP TypeScript SDK（13,080星）是用TypeScript构建MCP服务器和客户端的官方SDK。本文给出完整的最小服务器示例。

💡 你将学到

MCP TypeScript SDK（13,080星）是用TypeScript构建MCP服务器和客户端的官方SDK。本文给出完整的最小服务器示例。

直接给结论

modelcontextprotocol/typescript-sdk（13,080星，TypeScript）是MCP服务器和客户端的官方TypeScript SDK。它提供类型化的JSON-RPC协议封装——服务器注册、工具定义、资源处理和传输（stdio或HTTP）——几分钟就能上线一个MCP服务器。

为什么要构建MCP服务器

• 通过标准接口把你的应用或数据开放给AI助手（Claude、Cursor）
• 一次集成，所有支持MCP的客户端通用
• 让工具对模型保持类型化、文档化

TypeScript最小服务器

npm init -y
npm install @modelcontextprotocol/sdk zod

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

const server = new McpServer({
  name: "weather",
  version: "1.0.0",
});

server.tool(
  "get_forecast",
  { city: z.string() },
  async ({ city }) => ({
    content: [{ type: "text", text: `Forecast for ${city}: sunny, 24C` }],
  })
);

const transport = new StdioServerTransport();
await server.connect(transport);

构建并运行：npx tsc && node dist/index.js——然后加到任意MCP客户端配置里。

测试你的服务器

npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector node dist/index.js

Inspector UI可以列出工具、调用工具、查看原始JSON-RPC流量。

实用技巧

• 用zod定义输入模式——模型依赖它们正确调用工具。
• 本地客户端优先用stdio；远程服务器用HTTP传输。
• 出错时返回结构化错误内容，不要直接抛异常。

FAQ

需要懂底层协议吗？ 不需要——SDK封装了JSON-RPC；高级场景可参考规范（8,869星）。

也能构建客户端吗？ 能——SDK包含连接其他服务器的客户端类。

稳定吗？ 跟随MCP规范修订；生产环境请锁定SDK版本。