Java SDK 用于 Model Context Protocol 的实现， 使 AI 模型和工具之间能够进行标准化集成。

​
功能特性

  • MCP 客户端和服务器端实现支持：
  • 多种传输实现：
    • 默认传输：
      • 基于 stdio 的进程间通信传输
      • 基于 Java HttpClient 的 SSE 客户端传输，用于 HTTP SSE 客户端流
      • 基于 Servlet 的 SSE 服务器传输，用于 HTTP SSE 服务器流
    • 基于 Spring 的传输：
      • WebFlux SSE 客户端和服务器传输，用于响应式 HTTP 流
      • WebMVC SSE 传输，用于基于 servlet 的 HTTP 流
  • 支持同步和异步编程范式

​
架构

SDK 采用分层架构，具有明确的关注点分离： MCP 堆栈架构
  • 客户端/服务器层 (McpClient/McpServer)：两者都使用 McpSession 进行同步/异步操作， McpClient 处理客户端协议操作，McpServer 管理服务器端协议操作。
  • 会话层 (McpSession)：使用 DefaultMcpSession 实现管理通信模式和状态。
  • 传输层 (McpTransport)：通过以下方式处理 JSON-RPC 消息序列化/反序列化：
    • 核心模块中的 StdioTransport（标准输入/输出）
    • 专用传输模块中的 HTTP SSE 传输（Java HttpClient、Spring WebFlux、Spring WebMVC）

​
依赖项

将以下 Maven 依赖添加到您的项目中：
核心 MCP 功能：
<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
</dependency>
对于 HTTP SSE 传输实现，添加以下依赖项之一：
<!-- 基于 Spring WebFlux 的 SSE 客户端和服务器传输 -->
<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp-spring-webflux</artifactId>
</dependency>

<!-- 基于 Spring WebMVC 的 SSE 服务器传输 -->
<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp-spring-webmvc</artifactId>
</dependency>

​
物料清单 (BOM)

物料清单 (BOM) 声明了特定发布版本推荐使用的所有依赖项版本。 从您的应用程序的构建脚本中使用 BOM 可以避免您需要自己指定和维护依赖项版本。 相反，您使用的 BOM 版本决定了使用的依赖项版本。 它还确保您默认使用受支持和测试过的依赖项版本，除非您选择覆盖它们。 将 BOM 添加到您的项目中： 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.modelcontextprotocol.sdk</groupId>
            <artifactId>mcp-bom</artifactId>
            <version>0.7.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
将版本号替换为您想要使用的 BOM 版本。

​
可用依赖项

BOM 管理的可用依赖项如下：
  • 核心依赖项
    • io.modelcontextprotocol.sdk:mcp - 核心 MCP 库，提供 Model Context Protocol 实现的基本功能和 API。
  • 传输依赖项
    • io.modelcontextprotocol.sdk:mcp-spring-webflux - 基于 WebFlux 的服务器发送事件 (SSE) 传输实现，用于响应式应用程序。
    • io.modelcontextprotocol.sdk:mcp-spring-webmvc - 基于 WebMVC 的服务器发送事件 (SSE) 传输实现，用于基于 servlet 的应用程序。
  • 测试依赖项
    • io.modelcontextprotocol.sdk:mcp-test - MCP 应用程序的测试工具和支持。