← 返回目录

MCP TypeScript SDK

官方

框架 / SDK

用于构建 MCP 服务器和客户端的官方 TypeScript SDK

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 74 / 438
Stars: ★ 13.6k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Bun · Deno
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 14 天前

63FMRS · C

这是由 Model Context Protocol 维护方提供的 TypeScript SDK，覆盖服务器、客户端、stdio、Streamable HTTP 和可选框架中间件。它适合开发集成，不是一个提供现成业务工具的 MCP 服务器。

最强项 · 文档质量 14/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

14/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README 展示了服务器创建、工具注册和 stdio 连接的合理路径，并提到 HTTP、客户端和可诊断文档；但未提供已缓存的 manifest、源文件、CI 工作流或提交的测试证据，无法静态验证初始化握手、工具列表一致性、错误处理和依赖控制。因此按静态校准不超过 12，并因关键路径缺少可复核证据扣分。
安全与权限 12/20: README 提到 stdio、Streamable HTTP、认证和 OAuth 辅助功能，也列出 Express、Fastify、Hono 的 Host 头验证；这表明主要安全边界可见。另一方面，未提供权限范围、凭据存储、数据流、危险操作确认或默认网络行为的源代码证据。SDK 本身未显示明显恶意或高风险默认副作用，但缺失证据限制了评分。
维护活跃度 14/20: 仓库未归档，README 明确区分 v2 稳定线与 v1 安全更新，并说明 Apache-2.0 与既有 MIT 代码的许可安排；GitHub issues 和公开文档也提供了维护入口。未提供发布频率、提交活跃度、依赖更新、漏洞响应流程或明确维护者信息，因此不能给予高分。
文档质量 14/20: README 提供 Node.js、Bun、Deno 安装方式、服务器和客户端教程、API 文档、完整文档站、故障排查、OAuth、HTTP/stdio 指引及示例入口。未充分说明参数边界、限制、成本、凭据生命周期和常见安全故障，且实际示例与测试结果未在材料中验证，因此扣分。
安装易用性 13/20: 安装命令覆盖 npm、Bun 和 Deno，并分别说明服务器、客户端及多个中间件包；最小 stdio 服务器示例也较短。缺少面向主流客户端的完整配置示例、认证配置和可验证连接结果，且中间件选择增加了复杂度，所以未达到高分。

实测已过期收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

适合谁

使用 TypeScript 开发 MCP 服务器或客户端的开发者
需要 Node.js、Bun 或 Deno 运行时支持的项目
需要使用可选 Web 框架中间件集成 MCP 的项目

不适合谁

需要现成业务工具而非 SDK 的用户
需要已配置好的桌面客户端连接配置的用户
不使用 TypeScript 或 JavaScript 生态的项目

所需权限

权限取决于使用 SDK 构建的应用及其工具实现
使用 HTTP 集成时，应用可能需要处理请求、主机校验和 JSON 请求体
OAuth 权限取决于具体客户端或服务器实现

风险与副作用

SDK 本身不定义具体业务权限；实际风险取决于所构建工具访问的数据和操作
HTTP 服务的安全性取决于应用自身的主机校验、认证和部署配置
当前 main 分支是 v2，使用者需要注意与 v1 API 和文档的差异

安装接入

准备工作

运行环境：Node.js · Bun · Deno

服务器安装：npm install @modelcontextprotocol/server；客户端安装：npm install @modelcontextprotocol/client。也可使用 Bun 或 Deno 的对应安装方式。可选中间件包包括 @modelcontextprotocol/node、@modelcontextprotocol/express、@modelcontextprotocol/fastify 和 @modelcontextprotocol/hono。

验证是否装好

安装 @modelcontextprotocol/server 后，运行 README 中的 greet 示例，连接客户端时应能在工具列表中看到名为 greet 的工具，调用它返回 "Hello, <name>!" 样式的文本。

常见排障

确认安装了正确的 @modelcontextprotocol/server 或 @modelcontextprotocol/client 包
检查所使用的运行时是否为 Node.js、Bun 或 Deno
stdio 集成时确认客户端与服务器使用匹配的传输方式
HTTP 集成时检查主机请求校验、JSON 请求体解析和认证配置
查阅项目的故障排除文档及 v2 文档

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我用 @modelcontextprotocol/server 写一个最小 MCP 服务器，暴露一个 greet 工具。
用 Express 中间件包把我的 MCP 服务器挂到 HTTP 上。
写一个 MCP 客户端，连接上面的服务器并列出它的工具。

使用场景

构建 MCP 服务器并公开工具、资源或提示

构建 MCP 客户端并连接 MCP 服务器

通过 stdio 或 Streamable HTTP 集成 MCP

在 Express、Fastify、Hono 或 Node.js HTTP 应用中接入 MCP

详细介绍

MCP TypeScript SDK 是 Model Context Protocol 的 TypeScript 实现，支持在 Node.js、Bun 和 Deno 上构建 MCP 服务器与客户端。SDK 提供工具、资源、提示、stdio 与 Streamable HTTP，以及 OAuth 辅助功能，并包含 Express、Fastify、Hono 和 Node.js HTTP 的可选中间件包。