适合谁
- 使用 TypeScript 开发 MCP 服务器或客户端的开发者
- 需要 Node.js、Bun 或 Deno 运行时支持的项目
- 需要使用可选 Web 框架中间件集成 MCP 的项目
M
63FMRS · C
这是由 Model Context Protocol 维护方提供的 TypeScript SDK，覆盖服务器、客户端、stdio、Streamable 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 的可选中间件包。
工具能力
暂未整理工具清单。
安装接入
服务器安装：npm install @modelcontextprotocol/server；客户端安装：npm install @modelcontextprotocol/client。也可使用 Bun 或 Deno 的对应安装方式。可选中间件包包括 @modelcontextprotocol/node、@modelcontextprotocol/express、@modelcontextprotocol/fastify 和 @modelcontextprotocol/hono。
选型与风险
不适合谁
- 需要现成业务工具而非 SDK 的用户
- 需要已配置好的桌面客户端连接配置的用户
- 不使用 TypeScript 或 JavaScript 生态的项目
所需权限
- 权限取决于使用 SDK 构建的应用及其工具实现
- 使用 HTTP 集成时，应用可能需要处理请求、主机校验和 JSON 请求体
- OAuth 权限取决于具体客户端或服务器实现
风险与副作用
- SDK 本身不定义具体业务权限；实际风险取决于所构建工具访问的数据和操作
- HTTP 服务的安全性取决于应用自身的主机校验、认证和部署配置
- 当前 main 分支是 v2，使用者需要注意与 v1 API 和文档的差异
常见排障
- 确认安装了正确的 @modelcontextprotocol/server 或 @modelcontextprotocol/client 包
- 检查所使用的运行时是否为 Node.js、Bun 或 Deno
- stdio 集成时确认客户端与服务器使用匹配的传输方式
- HTTP 集成时检查主机请求校验、JSON 请求体解析和认证配置
- 查阅项目的故障排除文档及 v2 文档
使用场景
构建 MCP 服务器并公开工具、资源或提示
构建 MCP 客户端并连接 MCP 服务器
通过 stdio 或 Streamable HTTP 集成 MCP
在 Express、Fastify、Hono 或 Node.js HTTP 应用中接入 MCP
支持客户端
暂未确认支持的客户端。