Repolode
modelcontextprotocol

modelcontextprotocol/typescript-sdk

官方 TypeScript SDK,用于构建 Model Context Protocol 服务端与客户端,为 LLM 应用提供标准化上下文。

Star
13,620
Fork
2,543
未关闭 Issue
601
最近提交
18小时前

这是什么?

Model Context Protocol(MCP)让应用能以标准方式为大模型提供上下文,将上下文提供与模型交互本身分开。本仓库是 MCP 规范的官方 TypeScript 实现,分别提供用于构建服务端的 @modelcontextprotocol/server 和用于构建客户端的 @modelcontextprotocol/client。

服务端包支持工具(tools)、资源(resources)和提示词(prompts),并提供 Streamable HTTP 与 stdio 传输及认证辅助功能。客户端包提供多种传输方式、高层辅助函数和 OAuth 支持。工具与提示词的参数模式基于 Standard Schema,可搭配 Zod v4、Valibot、ArkType 等库使用。

SDK 可运行于 Node.js、Bun 和 Deno。可选的中间件包可接入 Express、Fastify、Hono 以及 Node.js 原生 HTTP 模块,仓库还附带可直接运行的示例。

核心功能

  • 01支持用工具、资源和提示词构建 MCP 服务端。
  • 02支持构建 MCP 客户端,包含多种传输方式和 OAuth 支持。
  • 03支持 Streamable HTTP 与 stdio 传输。
  • 04参数模式兼容 Zod v4、Valibot 等 Standard Schema 库。
  • 05可在 Node.js、Bun 和 Deno 上运行。
  • 06提供 Express、Fastify、Hono 和 Node.js HTTP 的可选中间件。

适用场景

  • 将内部 API 或数据源封装为工具,供 AI 助手调用。
  • 构建 TypeScript 客户端,让应用连接各类 MCP 服务端。
  • 将 MCP 服务端接入现有的 Express 或 Fastify 后端。

快速上手

  1. 1

    使用 npm 安装服务端包

    npm install @modelcontextprotocol/server
  2. 2

    按照 README 中的教程构建你的第一个服务器

使用前须知

  • 元数据中的许可证显示为 NOASSERTION;README 称新贡献采用 Apache-2.0,既有代码为 MIT。
  • 当前 main 分支为 v2,v1.x 在 v2 发布后仅会在有限时间内接收错误修复和安全更新。

标签

常见问题

typescript-sdk 是什么?
官方 TypeScript SDK,用于构建 Model Context Protocol 服务端与客户端,为 LLM 应用提供标准化上下文。 Model Context Protocol(MCP)让应用能以标准方式为大模型提供上下文,将上下文提供与模型交互本身分开。本仓库是 MCP 规范的官方 TypeScript 实现,分别提供用于构建服务端的 @modelcontextprotocol/server 和用于构建客户端的 @modelcontextprotocol/client。
typescript-sdk 可以免费使用吗?用的什么许可证?
typescript-sdk 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
typescript-sdk 还在维护吗?
活跃维护中。typescript-sdk 最近一次提交是在 2026年10月20日。
typescript-sdk 适合用来做什么?
将内部 API 或数据源封装为工具,供 AI 助手调用。 构建 TypeScript 客户端,让应用连接各类 MCP 服务端。 将 MCP 服务端接入现有的 Express 或 Fastify 后端。
typescript-sdk 怎么安装和运行?
使用 npm 安装服务端包: npm install @modelcontextprotocol/server 按照 README 中的教程构建你的第一个服务器
在哪里获取 typescript-sdk?
源代码和安装说明在 GitHub 上:https://github.com/modelcontextprotocol/typescript-sdk

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目