Model Context Protocol 客户端
MCP 客户端是 Model Context Protocol (MCP) 架构中的关键组件,负责与 MCP 服务器建立和管理连接。它实现了协议的客户端部分,处理以下内容:- 协议版本协商以确保与服务器的兼容性
- 能力协商以确定可用功能
- 消息传输和 JSON-RPC 通信
- 工具发现和执行
- 资源访问和管理
- 提示系统交互
- 可选功能如根目录管理和采样支持
核心
io.modelcontextprotocol.sdk:mcp
模块提供了 STDIO 和 SSE 客户端传输实现,无需外部 Web 框架。对于 Spring Framework 用户,Spring 特定的传输实现作为可选依赖 io.modelcontextprotocol.sdk:mcp-spring-webflux
提供。- 同步 API
- 异步 API
客户端传输
传输层处理 MCP 客户端和服务器之间的通信,为不同用例提供不同的实现。客户端传输管理消息序列化、连接建立和特定于协议的通信模式。- STDIO
- SSE (HttpClient)
- SSE (WebFlux)
为基于进程内的通信创建传输
客户端能力
客户端可以配置各种能力:根目录支持
根目录定义了服务器在文件系统中可以操作的边界:- 请求可访问的文件系统根目录列表
- 在根目录列表更改时接收通知
- 了解它们可以访问哪些目录和文件
采样支持
采样使服务器可以通过客户端请求 LLM 交互(“完成”或“生成”):- 服务器利用 AI 功能而无需 API 密钥
- 客户端保持对模型访问和权限的控制
- 支持基于文本和图像的交互
- 可选地在提示中包含 MCP 服务器上下文
使用 MCP 客户端
工具执行
工具是客户端可以发现和执行的服务器端函数。MCP 客户端提供了列出可用工具和使用特定参数执行它们的方。每种工具都有一个唯一的名称,并接受参数映射。- 同步 API
- 异步 API
资源访问
资源代表客户端可以使用 URI 模板访问的服务器端数据源。MCP 客户端提供了发现可用资源和通过标准化接口检索其内容的方法。- 同步 API
- 异步 API
提示系统
提示系统允许与服务器端提示模板进行交互。这些模板可以被发现并使用自定义参数执行,允许基于预定义模式进行动态文本生成。- 同步 API
- 异步 API