AgentIndex icon
AgentIndex
工具MCP 服务HOT分类热门最新选型清单对比指南
提交工具
工具MCP 服务HOT分类热门最新选型清单对比指南
首页/
MCP 服务器/
typescript-sdk
typescript-sdk logo

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 校验检查参数结构,不能决定当前用户是否有权执行业务动作;宿主仍要实现完成条件、权限、进程清理,以及各服务实际内容格式的错误处理。

阅读完整评测、验证范围与参考资料 →

已实际试用 · 2026-11-04 使用 @modelcontextprotocol/client and server 2.4.0; Zod 4.1.12 试用。

环境: macOS arm64、Node.js 26.6.0;人工 stdio 工具和一个资源,不调用模型或外部业务 API

执行的命令

node doc/review-fixtures/mcp-typescript-sdk/verify.mjs

实际结果

  • 初始化与发现、正常求和、非法数字参数、处理函数抛错、未知工具、资源读取和新进程状态均通过。
  • 非法参数未再次执行处理函数;业务抛错返回 isError true,未知工具抛出 -32602 协议异常。
  • 仅验证本地 stdio,未测试 HTTP、OAuth、多用户状态、Bun 和 Deno。

数据截至 2026-11-12。

许可证
GitHub 未识别
最新发布
v2.4.0 · 2026-10-23
最近提交
2026-11-10
贡献者
196
复刻数
2,380
未关闭的 issue 和 PR
665
首次发布
2024-09-24
npm 包
@modelcontextprotocol/server 2.4.0 · 27,535,812 上周下载

来源:GitHub、npm 和 PyPI 的公开接口。

#MCP#MCP 客户端#MCP 服务端#MCP 服务#TypeScript
$ 安装
$ npm install @modelcontextprotocol/[email protected] @modelcontextprotocol/[email protected]
↗ 访问官网★ GitHub
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 周每周提交数
近 12 周每周提交数: 2, 3, 2, 1, 5, 37, 6, 3, 14, 3, 0, 1

最早的一周在左边,最近 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
$ npm install @modelcontextprotocol/[email protected] @modelcontextprotocol/[email protected]
08

使用场景

↳用 TypeScript 构建 MCP 服务
↳为应用或智能体加入 MCP 客户端能力
09

同类工具

⚡热门对决:
VSmcphub★2.7k→VSTREK★15.7k→VSNavidrome-MCP★98→VSwhoop-mcp★144→
pinky logo
pinky★ 2.4k
通过 MCP 或内置智能体操作 iPhone 与安卓手机,并提供网关审批和人工接管的工具。
mcphub logo
mcphub★ 2.7k
MCPHub 通过将多个 MCP 服务器组织成灵活的 Streamable HTTP (SSE) 端点,从而简化其管理和扩展。
VS对比→
Godot-MCP logo
Godot-MCP★ 355
面向 Godot 引擎的 MCP 集成:让 Claude、Cursor、Copilot 等 AI 智能体直接检查并操作 Godot 编辑器中的项目。
TREK logo
TREK★ 15.7k
自托管的实时协作旅行规划工具,含地图、日程、预算、行李清单和旅行日志,可选开启 AI 助手和 MCP 服务。
VS对比→
Navidrome-MCP logo
Navidrome-MCP★ 98
将 Navidrome 音乐服务器接入 MCP,支持自然语言控制播放、构建歌单、发现音乐和探索全球电台。
VS对比→
whoop-mcp logo
whoop-mcp★ 144
通过逆向工程 Whoop iOS API 让 Claude 全面读写 Whoop 健身数据的 MCP 服务器,提供 47 个工具。
VS对比→
copilot-money-mcp logo
copilot-money-mcp★ 89
Copilot Money 应用的非官方 MCP 服务器,基于本地缓存数据用 AI 查询和管理个人财务。
VS对比→
mcp-music-studio logo
mcp-music-studio★ 80
双模式 MCP 音乐工作室:乐谱作曲(ABC 记谱)和现场演奏(Strudel),带交互界面、乐谱渲染和 30 多种乐器。
VS对比→
查看全部替代品 →

评论

登录后发表评论

暂无评论,来发表第一条吧

本页内容
01功能特性02为什么选择它03权衡点05维护状况检查04适合谁06兼容性07快速开始08使用场景09同类工具
modelcontextprotocol /
typescript-sdk
↗

用于构建 MCP 服务端与客户端的官方协议库

13.8k2.4kApache-2.0 / MIT
最后更新1周前
状态活跃
分类MCP 服务器
贡献者196
最新发布v2.4.0
链接
文档↗讨论↗问题↗版本↗
推荐云部署
Ad

在 DigitalOcean 上一键部署

为你的 MCP 服务、Docker 容器与智能体提供即开即用云服务器,新用户立享 $200 免费额度(60天有效)。

立即领取 $200 免费额度
© 2026 AgentIndex.app|由十年 iOS 开发者构建。
按场景挑选关于我们联系我们广告合作隐私政策使用条款QYSGitHub请作者喝咖啡 ☕

按分类浏览

MCP 服务器代码助手工作流自动化RAG / 知识库多智能体浏览器自动化大模型基础设施开发者工具可观测性

与 Anthropic, OpenAI 或 Microsoft 无关。