模型上下文协议（MCP）

模型上下文协议（MCP）是一种标准化协议，使 AI 模型能够以结构化的方式与外部工具和资源进行交互。它支持多种传输机制，以提供跨不同环境的灵活性。spring-doc.cadn.net.cn

MCP Java SDK 提供了模型上下文协议的 Java 实现，通过同步和异步通信模式实现与 AI 模型和工具的标准化交互。spring-doc.cadn.net.cn

Spring AI MCP通过 Spring Boot 集成扩展 MCP Java SDK，提供客户端和服务器Starters。使用 Spring Initializer 通过 MCP 支持引导您的 AI 应用程序。spring-doc.cadn.net.cn

MCP Java SDK 0.8.0 ⚠️ 中的重大变更spring-doc.cadn.net.cn

MCP Java SDK 0.8.0 版引入了多项重大更改，包括基于会话的新架构。如果您要从 Java SDK 0.7.0 升级，请参阅迁移指南以获取详细说明。spring-doc.cadn.net.cn

MCP Java SDK 架构

本节概述了 MCP Java SDK 架构。有关 Spring AI MCP 集成，请参阅 Spring AI MCP Boot Starters 文档。

Java MCP 实现遵循三层架构：spring-doc.cadn.net.cn

客户端/服务器层：McpClient 处理客户端作，而 McpServer 管理服务器端协议作。两者都利用 McpSession 进行通信管理。spring-doc.cadn.net.cn
会话层（McpSession）：通过 McpClientSession 和 McpServerSession 实现管理通信模式和状态。spring-doc.cadn.net.cn
传输层（McpTransport）：处理 JSON-RPC 消息序列化和反序列化，支持多种传输实现。spring-doc.cadn.net.cn

MCP 客户端
MCP 客户端是模型上下文协议（MCP）架构中的关键组件，负责建立和管理与 MCP 服务器的连接。它实现协议的客户端，处理：spring-doc.cadn.net.cn 协议版本协商，确保与服务器的兼容性spring-doc.cadn.net.cn 功能协商以确定可用功能spring-doc.cadn.net.cn 消息传输和 JSON-RPC 通信spring-doc.cadn.net.cn 工具发现和执行spring-doc.cadn.net.cn 资源访问和管理spring-doc.cadn.net.cn 提示系统交互spring-doc.cadn.net.cn 可选功能：spring-doc.cadn.net.cn 根管理spring-doc.cadn.net.cn 采样支持spring-doc.cadn.net.cn 同步和异步作spring-doc.cadn.net.cn 交通选择：spring-doc.cadn.net.cn 基于 Stdio 的传输，用于基于流程的通信spring-doc.cadn.net.cn Java HttpClient 的 SSE 客户端传输spring-doc.cadn.net.cn 用于响应式 HTTP 流的 WebFlux SSE 客户端传输spring-doc.cadn.net.cn

MCP 客户端是模型上下文协议（MCP）架构中的关键组件，负责建立和管理与 MCP 服务器的连接。它实现协议的客户端，处理：spring-doc.cadn.net.cn

协议版本协商，确保与服务器的兼容性spring-doc.cadn.net.cn
功能协商以确定可用功能spring-doc.cadn.net.cn
消息传输和 JSON-RPC 通信spring-doc.cadn.net.cn
工具发现和执行spring-doc.cadn.net.cn
资源访问和管理spring-doc.cadn.net.cn
提示系统交互spring-doc.cadn.net.cn
可选功能：spring-doc.cadn.net.cn
- 根管理spring-doc.cadn.net.cn
- 采样支持spring-doc.cadn.net.cn
同步和异步作spring-doc.cadn.net.cn
交通选择：spring-doc.cadn.net.cn
- 基于 Stdio 的传输，用于基于流程的通信spring-doc.cadn.net.cn
- Java HttpClient 的 SSE 客户端传输spring-doc.cadn.net.cn
- 用于响应式 HTTP 流的 WebFlux SSE 客户端传输spring-doc.cadn.net.cn

MCP 服务器
MCP 服务器是模型上下文协议（MCP）架构中的一个基础组件，它为客户端提供工具、资源和功能。它实现协议的服务器端，负责：spring-doc.cadn.net.cn 服务器端协议作实现spring-doc.cadn.net.cn 工具暴露和发现spring-doc.cadn.net.cn 使用基于 URI 的访问进行资源管理spring-doc.cadn.net.cn 提示模板提供和处理spring-doc.cadn.net.cn 与客户进行能力谈判spring-doc.cadn.net.cn 结构化日志记录和通知spring-doc.cadn.net.cn 并发客户端连接管理spring-doc.cadn.net.cn 同步和异步 API 支持spring-doc.cadn.net.cn 传输实现：spring-doc.cadn.net.cn 基于 Stdio 的传输，用于基于流程的通信spring-doc.cadn.net.cn 基于 Servlet 的 SSE 服务器传输spring-doc.cadn.net.cn 用于响应式 HTTP 流的 WebFlux SSE 服务器传输spring-doc.cadn.net.cn 用于基于 servlet 的 HTTP 流的 WebMVC SSE 服务器传输spring-doc.cadn.net.cn

MCP 服务器是模型上下文协议（MCP）架构中的一个基础组件，它为客户端提供工具、资源和功能。它实现协议的服务器端，负责：spring-doc.cadn.net.cn

服务器端协议作实现spring-doc.cadn.net.cn
- 工具暴露和发现spring-doc.cadn.net.cn
- 使用基于 URI 的访问进行资源管理spring-doc.cadn.net.cn
- 提示模板提供和处理spring-doc.cadn.net.cn
- 与客户进行能力谈判spring-doc.cadn.net.cn
- 结构化日志记录和通知spring-doc.cadn.net.cn
并发客户端连接管理spring-doc.cadn.net.cn
同步和异步 API 支持spring-doc.cadn.net.cn
传输实现：spring-doc.cadn.net.cn
- 基于 Stdio 的传输，用于基于流程的通信spring-doc.cadn.net.cn
- 基于 Servlet 的 SSE 服务器传输spring-doc.cadn.net.cn
- 用于响应式 HTTP 流的 WebFlux SSE 服务器传输spring-doc.cadn.net.cn
- 用于基于 servlet 的 HTTP 流的 WebMVC SSE 服务器传输spring-doc.cadn.net.cn

有关使用低级 MCP 客户端/服务器 API 的详细实现指南，请参阅 MCP Java SDK 文档。要使用 Spring Boot 简化设置，请使用下面描述的 MCP Boot Starters。spring-doc.cadn.net.cn

Spring AI 通过以下 Spring Boot Starters提供 MCP 集成：spring-doc.cadn.net.cn

spring-ai-starter-mcp-client- 提供基于 STDIO 和 HTTP 的 SSE 支持的核心Startersspring-doc.cadn.net.cn
spring-ai-starter-mcp-client-webflux- 基于 WebFlux 的 SSE 传输实现spring-doc.cadn.net.cn

spring-ai-starter-mcp-server- 支持 STDIO 传输的核心服务器spring-doc.cadn.net.cn
spring-ai-starter-mcp-server-webmvc- 基于 Spring MVC 的 SSE 传输实现spring-doc.cadn.net.cn
spring-ai-starter-mcp-server-webflux- 基于 WebFlux 的 SSE 传输实现spring-doc.cadn.net.cn