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

模型上下文协议 (MCP)

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

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

Spring AI MCP 通过 Spring Boot 集成扩展了 MCP Java SDK，提供了 客户端 和 服务器 Starters。 使用 Spring Initializer 为您的 AI 应用程序引入 MCP 支持。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

MCP Stack Architecture

  • 客户端/服务器层: 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
Java MCP Client Architecture
MCP 服务器

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

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

Spring AI MCP 集成

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

客户端Starters

服务器Starters

附加资源