DDDD MCP TypeScript SDK

DDDD MCP TypeScript SDK

site icon
2025.04.30 0
TypeScriptLLM 交互API 封装数据库集成开发效率
mcp-ts-sdk 是一个 TypeScript 实现的 Model Context Protocol (MCP) SDK,旨在为 LLM 应用提供标准化的上下文交互方式。它允许开发者构建 MCP 客户端和服务端,通过标准传输方式(如 stdio 和 Streamable HTTP)实现资源、工具和提示的暴露与管理。
View on GitHub

Overview

基本能力

产品定位

mcp-ts-sdk 是一个用于构建 MCP 客户端和服务端的 TypeScript SDK,专注于为 LLM 应用提供标准化的上下文交互方式。

核心功能

  • 构建 MCP 客户端和服务端:支持连接到任何 MCP 服务器或创建自定义 MCP 服务器。
  • 资源管理:通过资源(Resources)暴露数据,类似于 REST API 的 GET 端点。
  • 工具调用:通过工具(Tools)提供功能,类似于 REST API 的 POST 端点。
  • 提示模板:通过提示(Prompts)定义 LLM 交互的可重用模板。
  • 多种传输方式:支持 stdio 和 Streamable HTTP 等标准传输方式。

适用场景

  • LLM 上下文管理:为 LLM 应用提供动态数据加载和功能调用。
  • 数据库集成:如 SQLite 数据库的查询和模式管理。
  • API 封装:将外部 API 封装为 MCP 工具供 LLM 调用。
  • OAuth 代理:代理 OAuth 请求到外部授权提供商。

工具列表

  • MCP Inspector:用于测试和调试 MCP 服务器的工具。
  • StdioServerTransport:用于命令行工具和直接集成的 stdio 传输。
  • StreamableHTTPServerTransport:用于远程服务器的 Streamable HTTP 传输。
  • SSEServerTransport:用于向后兼容的 SSE 传输(已弃用)。

常见问题解答

  • 如何测试服务器?:使用 MCP Inspector 进行测试和调试。
  • 如何实现会话管理?:通过 Streamable HTTP 传输的会话管理功能实现。
  • 如何向后兼容?:支持 Streamable HTTP 和 SSE 传输的混合模式。

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

npm install @modelcontextprotocol/sdk

调试方式

使用 MCP Inspector 进行调试,具体命令参考其 README。

高级用法

动态服务器

可以在服务器连接后动态添加、更新或删除工具、提示和资源。

低级别服务器

使用低级别 Server 类直接控制协议实现。

客户端开发

使用 Client 类构建 MCP 客户端,支持多种传输方式。

OAuth 代理

通过 ProxyOAuthServerProvider 代理 OAuth 请求到外部提供商。

向后兼容

支持 Streamable HTTP 和 SSE 传输的混合模式以实现向后兼容。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。