KKGABC

MCP Java SDK

7 条已验证来源

Model Context Protocol 官方 Java SDK(Tier 2,与 Spring AI 协作维护),Java 17+ 同步/异步 API 同时支持 2026-07-28 无状态新协议与 2025-11-25 传统协议

工具简介

它是什么

MCP Java SDK(仓库 modelcontextprotocol/java-sdk)是 Model Context Protocol 官方认定的 Tier 2 Java SDK,由 MCP 团队与 Spring AI 协作维护,面向 Java 17+ 应用提供构建 MCP 服务端与客户端的参考实现。

双代协议并行

  • 2.2.0 版本(2026-11-16)在同一套依赖中并行支持两代协议
  • Modern:无状态、取消会话与 initialize 握手的 2026-07-28 规范(io.modelcontextprotocol.modern 包,入口 McpServer 与 McpClient)
  • Legacy:2025-11-25 及更早的会话式规范;两者均可用同步 API 或基于 Project Reactor 的异步 API

协议能力

  • 支持 tools、resources 与 URI 模板、prompts、参数补全
  • Modern 侧通过多轮往返请求支持表单与 URL elicitation,并支持 progress 通知、subscriptions/listen 变更通知、结果缓存提示(ttlMs)与 SEP-2243 自定义 HTTP 头
  • Modern 客户端暂不支持 sampling、roots、logging 与扩展,相关 API 依 SEP-2577 弃用但线协议行为不变

传输与序列化

  • 无需 Web 框架即可使用 STDIO 与 Streamable HTTP(客户端 JDK HttpClient、服务端 Servlet API),Legacy 的 SSE 传输已弃用
  • JSON 序列化经抽象层,默认 Jackson 3,可切换 Jackson 2
  • 模块包括 mcp-bom、mcp-core、mcp-json-jackson2/3、便捷包 mcp 与 mcp-test

安全与生态

  • 提供可插拔授权钩子及可选的 Host/Origin 校验以防 DNS rebinding
  • Spring WebFlux/WebMVC 传输、Boot Starter 与 @McpTool 等注解由 Spring AI 2.0+/2.1+ 提供
  • MIT 许可开源,一致性测试旧版服务端套件 40/40 通过

本页内容来自 KGABC 结构化知识库。带「未验证」标记的字段表示官方资料未明确说明,不等同于「不支持」。

核心功能

  • 官方 Tier 2 SDK(与 Spring AI 协作维护)
  • Java 17+,同步 API 与 Project Reactor 异步 API 双形态
  • Modern 实现支持无状态 2026-07-28 规范(无会话/无 initialize 握手)
  • Legacy 实现兼容 2025-11-25 及更早规范
  • io.modelcontextprotocol.modern.server.McpServer / client.McpClient 入口
  • tools / resources / prompts / completions 全支持
  • 表单与 URL elicitation(多轮往返请求)
  • subscriptions/listen 变更通知与结果缓存提示(ttlMs)
  • SEP-2243 Mcp-Param 自定义请求头校验
  • STDIO + Streamable HTTP(JDK HttpClient / Servlet API)传输
  • 可插拔 JSON 序列化(Jackson 3 默认,可切 Jackson 2)
  • 可插拔授权钩子与 Host/Origin 防 DNS rebinding 校验
  • 模块化依赖:mcp-bom / mcp-core / mcp-json-jackson2|3 / mcp / mcp-test
  • Spring AI 2.0+/2.1+ 提供 WebFlux/WebMVC 传输、Boot Starter 与注解
  • MIT 许可,旧版服务端一致性测试 40/40 通过

适用场景

  • 用 Java 编写无状态 MCP Server 暴露工具/资源/提示并水平扩展
  • 用 Java 构建 MCP Client 连接任意 MCP 服务端
  • 在 Spring Boot 应用中通过 Starter 与 @McpTool 注解集成 MCP
  • 从 2025-11-25 会话式协议平滑迁移到 2026-07-28 无状态协议
  • 在 JDK HttpClient + Servlet 环境中零 Web 框架依赖地部署 MCP 服务
  • 通过 mcp-test 模块对 MCP 服务端做集成与一致性测试

优势

  • 官方 SDK,Tier 2 维护承诺且随规范快速演进
  • 一套依赖同时覆盖新旧两代 MCP 协议
  • 同步与异步 API 并存,适配阻塞与流式场景
  • 无状态 Modern 服务端天然适合多副本部署
  • 传输与 JSON 层可插拔,依赖精简
  • Spring AI 生态深度集成(Boot Starter/注解/Web 传输)
  • MIT 许可,可商用

技术能力

APISDKMCP 支持开源可自托管云服务未验证本地运行未验证

编程语言

协议

信息来源与可信度

共 7 条 · 7 条已验证
来源类型依据状态
MCP 官方 SDK 列表

https://modelcontextprotocol.io/docs/2026-07-28/sdk

官方 SDK 列表将 Java SDK 列为 Tier 2,并链接文档站与仓库已验证
modelcontextprotocol/java-sdk (官方仓库)

https://github.com/modelcontextprotocol/java-sdk

README 说明与 Spring AI 协作维护、模块结构、传输选型、Spring 集成与 MIT 许可已验证
LICENSE (MIT)

https://github.com/modelcontextprotocol/java-sdk/blob/main/LICENSE

仓库 LICENSE 文件为 MIT License已验证
MCP Java SDK 文档站

https://java.sdk.modelcontextprotocol.io/

文档说明 Java 17+、Modern/Legacy 双协议实现、特性矩阵、传输与安全钩子已验证
MCP Java SDK v2.2.0 Release Notes

https://github.com/modelcontextprotocol/java-sdk/releases/tag/v2.2.0

2026-11-16 发布的 v2.2.0 新增 2026-07-28 无状态服务端与客户端,并列出 Modern API 特性已验证
MCP SDK Tiers

https://modelcontextprotocol.io/community/sdk-tiers

官方定义 Tier 2 为积极维护并承诺走向完整规范支持,要求 80% 一致性与半年内跟进新规范已验证
Spring AI 2.1.0-RC2 Available Now

https://spring.io/blog/2026/11/09/spring-ai-2-1-0-RC2-available-now

官方博客确认 Spring AI MCP 现代服务端基于 MCP Java SDK 2.2 现代 API,并提供 WebMVC/WebFlux 与 STDIO 传输已验证
最后验证时间:Fri Nov 20来源优先级:官网 > 官方文档 > 官方 GitHub > 官方定价页 > 第三方资料