模型上下文协议SDK

模型上下文协议（MCP）文档

此存储库包含模型上下文协议（MCP）的文档，包括TypeScript的客户端和服务器SDK。

---

TypeScript MCP客户端SDK

TypeScript的模型上下文协议（MCP）客户端SDK允许您构建连接到MCP服务器的客户端（通常称为“主机”或“代理”），以使用其工具、资源和提示。

入门指南

1. 快速入门：连接到服务器并在几分钟内调用工具。
2. 建筑：了解客户端<->传输<->服务器关系。

API 参考

• 客户端：用于连接到服务器和发出请求的核心类。
• 运输: StdioClientTransport （CLI）和 SSEClientTransport （HTTP）。
• 类型：TypeScript定义。

能力

了解如何使用MCP服务器公开的功能：

• 工具：发现并执行服务器端函数。
• 资源：读取数据文件并订阅更新。
• 提示：检索提示模板。
• 根：向服务器公开本地文件系统根。
• 采样：允许服务器向您的LLM（循环中的人）请求完成。

实现模式

• 主机应用程序：将MCP客户端集成到IDE或代理中的最佳实践。

---

TypeScript MCP服务器SDK

TypeScript的模型上下文协议（MCP）服务器SDK允许您构建向LLM和其他客户端公开数据（资源）、可执行逻辑（工具）和模板（提示）的服务器。

入门指南

1. 快速入门：在5分钟内构建您的第一台服务器。
2. 建筑：了解传输层、协议层和服务器层是如何协同工作的。

API 参考

• McpServer：构建服务器的核心类。
• 运输: StdioServerTransport （CLI）和 StreamableHTTPServerTransport （HTTP://SSE）。
• 类型：TypeScript定义。

能力

了解如何实现MCP的核心功能：

• 工具：使用Zod验证注册可执行函数。
• 资源：通过URI公开文件内容或数据。
• 提示：创建可重用的提示模板。
• 采样：向客户的法学硕士请求完成（“思考”）。

实现模式

• 认证：使用OAuth和Bearer令牌保护您的服务器。
• 错误处理：使用 McpError 以及稳健故障模式的标准规范。