获取最新的快照版本，请使用 Spring AI 1.1.3！spring-doc.cadn.net.cn

模型上下文协议(MCP)

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

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

Spring AI MCP 扩展了 MCP Java SDK 的 Spring Boot 集成，提供客户端和服务器端 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

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 WebFlux SSE 客户端传输，用于响应式 HTTP 流式传输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
- WebFlux SSE 客户端传输，用于响应式 HTTP 流式传输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 WebFlux SSE 服务器传输，用于响应式 HTTP 流式传输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
- WebFlux SSE 服务器传输，用于响应式 HTTP 流式传输spring-doc.cadn.net.cn
- 基于 Servlet 的 HTTP 流式传输的 WebMVC SSE 服务器传输spring-doc.cadn.net.cn

有关详细实施指导，使用低级MCP客户端/服务器API，请参阅MCP Java SDK文档。对于使用Spring Boot进行的简化设置，请使用下文所述的MCPStarters。spring-doc.cadn.net.cn

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

spring-ai-starter-mcp-client - 核心Starters，提供 STDIO 和基于 HTTP 的 SSE 支持spring-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