特性
- MCP客户端和MCP服务器实现支持:
- 多种传输实现:
- 默认传输:
- 基于标准输入输出的进程间通信传输
- 基于Java HttpClient的SSE客户端传输,用于HTTP SSE客户端流式传输
- 基于Servlet的SSE服务器传输,用于HTTP SSE服务器流式传输
- 基于Spring的传输:
- WebFlux SSE客户端和服务器传输,用于响应式HTTP流式传输
- WebMVC SSE传输,用于基于servlet的HTTP流式传输
- 默认传输:
- 支持同步和异步编程范式
Spring AI MCP扩展了MCP Java SDK并集成了Spring Boot,
提供了客户端和服务器 Boot启动器。
您可以使用Spring Initializer引导您的AI Spring应用程序。
架构
该SDK遵循分层架构,具有明确的关注点分离:- 客户端/服务器层(McpClient/McpServer):两者都使用McpSession进行同步/异步操作, McpClient处理客户端协议操作,McpServer管理服务器端协议操作。
- 会话层(McpSession):使用DefaultMcpSession实现管理通信模式和状态。
- 传输层(McpTransport):通过以下方式处理JSON-RPC消息的序列化/反序列化:
- 核心模块中的StdioTransport(标准输入/输出)
- 专用传输模块中的HTTP SSE传输(Java HttpClient、Spring WebFlux、Spring WebMVC)


- 客户端/服务器初始化:传输设置、协议兼容性检查、能力协商和实现细节交换。
- 消息流:JSON-RPC消息处理,包括验证、类型安全的响应处理和错误处理。
- 资源管理:资源发现、基于URI模板的访问、订阅系统和内容检索。
依赖
将以下Maven依赖添加到您的项目中:核心MCP功能:对于HTTP SSE传输实现,添加以下依赖之一:
物料清单(BOM)
物料清单(BOM)声明了特定发布版本使用的所有依赖项的推荐版本。 从您的应用程序的构建脚本中使用BOM可以避免您需要自己指定和维护依赖项版本。 相反,您使用的BOM版本决定了所使用的依赖项版本。 它还确保您默认使用受支持和经过测试的依赖项版本,除非您选择覆盖它们。 将BOM添加到您的项目中:可用依赖
BOM管理以下可用依赖:- 核心依赖
io.modelcontextprotocol.sdk:mcp
- 核心MCP库,提供模型上下文协议实现的基本功能和API。
- 传输依赖
io.modelcontextprotocol.sdk:mcp-spring-webflux
- 基于WebFlux的服务器发送事件(SSE)传输实现,用于响应式应用程序。io.modelcontextprotocol.sdk:mcp-spring-webmvc
- 基于WebMVC的服务器发送事件(SSE)传输实现,用于基于servlet的应用程序。
- 测试依赖
io.modelcontextprotocol.sdk:mcp-test
- MCP基础应用程序的测试工具和支持。