模型上下文协议（MCP）

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

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

春季 AI MCP通过 Spring Boot 集成扩展了 MCP Java SDK，提供客户端和服务器的入门工具。使用 Spring 初始化器启动支持 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 启动启动文档。

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 WebMVC SSE 服务器传输用于基于 servlet 的 HTTP 流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
- WebMVC SSE 服务器传输用于基于 servlet 的 HTTP 流spring-doc.cadn.net.cn

有关使用低级MCP客户端/服务器API的详细实现指导，请参阅MCP Java SDK文档。为了简化使用 Spring Boot 的设置，请使用下面介绍的 MCP 启动启动工具。spring-doc.cadn.net.cn

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

Spring-AI-starter-mcp-client- Core starter，提供基于 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