modelcontextprotocol/typescript-sdk

Model Context Protocol (MCP) TypeScript SDK – 快速概览

是什么 – 一组 TypeScript 库，可让您构建 Model Context Protocol (MCP) 服务器和客户端。MCP 是一种轻量级、语言无关的规范，用于向大型语言模型提供结构化上下文（工具、资源、提示等）。该 SDK 实现了 2026 年 7 月版规范，可在 Node.js、Bun 和 Deno 上运行。

核心包

• @modelcontextprotocol/server – 用于定义工具、资源，并通过 HTTP、stdio 或其他传输方式暴露它们的辅助工具。
• @modelcontextprotocol/client – 用于发现服务器功能并调用其工具的实用程序。
• 可选的中间件适配器（@modelcontextprotocol/express、fastify、hono、node）可轻松将 MCP 集成到流行的 Web 框架中。

如何使用

1. 创建服务器 – 实例化 McpServer，使用 Zod（或兼容）模式注册工具，并附加传输方式（例如 StdioServerTransport）。
2. 创建客户端 – 使用客户端包连接到服务器，列出可用工具并调用它们。
3. 部署 – 通过轻量级中间件包将服务器接入任何 HTTP 运行时。

为何重要 – 通过将 上下文提供 与 LLM 调用分离，MCP 允许开发者在不同模型、云提供商或本地运行时中重用相同的工具定义。该 SDK 提供了开箱即用、类型安全的方式来采用该规范，无需自行实现协议处理。

文档与支持 – 完整指南、API 参考和迁移说明托管在 https://ts.sdk.modelcontextprotocol.io/v2/。可在 GitHub 上提交问题，项目采用 Apache-2.0（新代码） / MIT（旧代码）许可证。

---

TL;DR

• 目的：构建和使用符合 MCP 的服务，向 LLM 提供结构化上下文。
• 语言：TypeScript（Node、Bun、Deno）。
• 核心库：@modelcontextprotocol/server 与 @modelcontextprotocol/client。
• 附加功能：Express、Fastify、Hono、原生 Node HTTP 的轻量级适配器。
• 快速开始：npm i @modelcontextprotocol/server @modelcontextprotocol/client，然后跟随“第一个服务器/客户端”教程。