模型上下文协议 (MCP)
模型上下文协议（MCP）是一个标准化协议，使 AI 模型能够以结构化的方式与外部工具和资源交互。 它支持多种传输机制，以在不同环境中提供灵活性。
MCP Java SDK 提供了模型上下文协议的 Java 实现，通过同步和异步通信模式实现与 AI 模型和工具的标准化交互。
Spring AI MCP 通过 Spring Boot 集成扩展了 MCP Java SDK，提供了 Client 和 Server Starter。 使用 Spring Initializer 引导具有 MCP 支持的 AI 应用程序。
MCP Java SDK 架构
提示：本节提供了 MCP Java SDK 架构 的概述。 对于 Spring AI MCP 集成，请参阅 Spring AI MCP Starter 文档。
Java MCP 实现遵循三层架构：
-
Client/Server Layer： McpClient 处理 Client 操作，而 McpServer 管理 Server 端协议操作。两者都使用 McpSession 进行通信管理。
-
会话层（McpSession）： 通过 DefaultMcpSession 实现管理通信模式和状态。
-
传输层（McpTransport）： 处理 JSON-RPC 消息的序列化和反序列化，支持多种传输实现。
MCP Client
MCP Client 是模型上下文协议（MCP）架构中的关键组件，负责建立和管理与 MCP Server 的连接。它实现了协议的 Client 部分，处理：
-
协议版本协商以确保与服务器的兼容性
-
能力协商以确定可用功能
-
消息传输和 JSON-RPC 通信
-
工具发现和执行
-
资源访问和管理
-
提示系统交互
-
可选功能：
-
根管理
-
采样支持
-
-
同步和异步操作
-
传输选项：
-
基于 Stdio 的传输用于基于进程的通信
-
基于 Java HttpClient 的 SSE 客户端传输
-
WebFlux SSE 客户端传输用于反应式 HTTP 流
-
MCP Server
MCP Server 是模型上下文协议（MCP）架构中的基础组件，为 Client 提供工具、资源和功能。它实现了协议的 Server 端，负责：
-
Server 端协议操作实现
-
工具暴露和发现
-
基于 URI 的资源管理
-
提示模板提供和处理
-
与客户端的能力协商
-
结构化日志和通知
-
-
并发客户端连接管理
-
同步和异步 API 支持
-
传输实现：
-
基于 Stdio 的传输用于基于进程的通信
-
基于 Servlet 的 SSE 服务器传输
-
基于 WebFlux 的 SSE 服务器传输用于反应式 HTTP 流
-
基于 WebMVC 的 SSE 服务器传输用于基于 Servlet 的 HTTP 流
-
有关使用低级 MCP Client/Server API 的详细实现指南，请参阅 MCP Java SDK 文档。 对于使用 Spring Boot 的简化设置，请使用下面描述的 MCP Starter。
Spring AI MCP 集成
Spring AI 通过以下 Spring Boot Starter 提供 MCP 集成：
Client Starter
-
spring-ai-starter-mcp-client- 提供 STDIO 和基于 HTTP 的 SSE 支持的核心 Starter -
spring-ai-starter-mcp-client-webflux- 基于 WebFlux 的 SSE 传输实现 Client Starter
Server Starter
-
spring-ai-starter-mcp-server- 具有 STDIO 传输支持的核心 Server Starter -
spring-ai-starter-mcp-server-webmvc- 基于 Spring MVC 的 SSE 传输实现 Server Starter -
spring-ai-starter-mcp-server-webflux- 基于 WebFlux 的 SSE 传输实现 Server Starter