typescript-sdk
活跃·★ 13.8k·Apache-2.0 / MIT·更新于 2026-11-10
★ 最受欢迎
官方 MCP TypeScript SDK 为团队提供协议基础:既可以把工具和资源提供给智能体,也可以在自有宿主中连接 MCP 服务。当前 v2 使用拆分的服务端和客户端包,旧的 @modelcontextprotocol/sdk 则属于 v1 维护线。混用示例、传输和错误处理代码前应先确认版本,相似名称不代表两代库构造的对象可以互换。
我们在 Node.js 26.6.0 上,以客户端和服务端 2.4.0、Zod 4.1.12 运行了人工 stdio 服务。初始化和发现成功,2 与 3 相加返回 5;给数字字段传入字符串时,调用在再次进入求和函数前被拒绝。处理函数主动抛错返回 isError true,未知工具触发代码为 -32602 的协议异常;资源读取能查看调用次数,新服务进程的计数从 0 开始。
这次检查没有调用模型或真实业务服务,只验证本地协议契约,没有验证 HTTP 部署、OAuth、共享多用户状态、Bun 或 Deno。Schema 校验检查参数结构,不能决定当前用户是否有权执行业务动作;宿主仍要实现完成条件、权限、进程清理,以及各服务实际内容格式的错误处理。
阅读完整评测、验证范围与参考资料 →#MCP#MCP 客户端#MCP 服务端#MCP 服务#TypeScript
01
功能特性
01服务端库,支持工具、资源和提示词
02客户端库,带传输层和 OAuth 辅助
03Streamable HTTP 和 stdio 传输
04支持 Standard Schema:Zod v4、Valibot、ArkType
05Express、Fastify、Hono、Node.js HTTP 中间件
02
为什么选择它
+实测客户端与服务端可以在不调用模型的情况下完成发现、调用和资源读取。
+数字 Schema 在进入业务函数前拒绝了非法输入,资源中的调用计数核对了这一行为。
+服务端、客户端与 HTTP 适配包分开发布,应用可按实际角色声明依赖。
03
权衡点
!v1 到 v2 的迁移涉及包名、适配器和错误契约,需要检查的范围超过版本号。
!SDK 不提供应用自身的业务权限规则,也不能决定模型是否已完成用户任务。
!本次 stdio 检查没有建立生产 HTTP、OAuth 或多用户隔离的验证结论。
05
维护状况检查
活跃检查日期: 2026-11-10
- 最近提交
- 2026-11-10
- 近 90 天提交数
- 85
- 近 90 天发布数
- 30
- 最新发布
- v2.4.0 (2026-10-23)
- 未关闭 issue
- 661
- 近期 issue 至少有一条评论的比例
- 19/20
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #1238 Feature Request: Middleware support for McpServer15 条评论 · 2025-12-05
- #2695 `maxTotalTimeout` is never enforced unless a progress notification arrives12 条评论 · 2026-08-21
- #3053 Streamable HTTP: the POST for a cancelled request never settles11 条评论 · 2026-10-19
- #2677 tools/list emits draft-07 $schema for Zod v4 schemas: toJsonSchemaCompat is called without a target, and mapMiniTarget defaults to 'draft-7'8 条评论 · 2026-08-17
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 正在实现 TypeScript MCP 服务或宿主,需要直接控制协议接入。
- 能够为参数、失败路径、生命周期和对端版本维护契约检查。
建议换别的情况
- 只需要已经配置好的智能体,不打算开发协议接入。
- 还无法投入本地演示之外的业务权限与部署工作。
06
兼容性
Node.js
20 及以上,本次使用 26.6.0
已通过文档验证
Bun
官方支持,本次未测
已通过文档验证
Deno
官方支持,本次未测
已通过文档验证
07
快速开始
1
08
使用场景
↳用 TypeScript 构建 MCP 服务
↳为应用或智能体加入 MCP 客户端能力
09
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧