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

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

💡 你将学到

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

📜 目录

• 直接给结论
• 为什么要构建MCP服务器
• TypeScript最小服务器
• 测试你的服务器
• 实用技巧
• FAQ
• 相关文章

直接给结论

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版本。

相关文章

• Windmill（1.7万星）开发者平台2026：把Python和TypeScript脚本变成应用与工作流
• 什么是MCP服务器？2026年新手解释
• Semantic Kernel（2.8万星）2026：微软的AI智能体构建SDK，支持插件与记忆

❓ 常见问题

Do I need to know the raw protocol?

No - the SDK wraps JSON-RPC; but reading the spec (8,869 stars) helps for advanced cases.

Can I build clients with it too?

Yes - the SDK includes client classes for connecting to other servers.

Is it stable?

It tracks the MCP spec revisions; pin your SDK version for production.