java-sdk
活跃·★ 3.7k·MIT·更新于 2026-10-27
★ 必备神器
这是 Model Context Protocol 的官方 Java SDK,让 Java 应用通过标准接口充当 MCP 客户端或服务端。它同时支持同步和异步两种风格,以 `io.modelcontextprotocol.sdk:mcp` 发布在 Maven Central,README 的徽章标明 JDK 17。README 链接了功能、架构、依赖与 BOM 的文档,以及独立的客户端和服务端指南,并说明 Spring AI MCP 在此 SDK 基础上提供了 Spring Boot 的客户端和服务端 starter。
README 的大部分篇幅在解释设计决策。JSON 使用 Jackson,放在 `mcp-core` 的 SDK 抽象之后,因此可以换成其他库。对外的编程模型是 Reactive Streams,内部用 Project Reactor 实现,并在上面提供同步外观,方便简单的阻塞式使用。日志使用 SLF4J,可观测性通过 Reactor Context 传递;SDK 同时支持客户端传输和带授权的服务端传输。README 还介绍了从源码构建、运行单元测试和一致性测试,并列出了未来方向。
#Java开发工具包#AI集成#API封装#异步编程#响应式编程#Spring Boot#JSON序列化
01
功能特性
01标准化的AI模型和工具交互
02支持同步和异步通信
03可插拔的JSON序列化(默认使用Jackson)
04响应式流编程模型(Project Reactor)及同步门面
05通过Spring AI MCP实现全面的Spring Boot集成
02
为什么选择它
+MCP 官方 SDK,已发布到 Maven Central
+同时提供同步和异步 API,简单的阻塞式使用不需要先学 Reactor
+JSON 层可替换,没有把 Jackson 写死在公开 API 里
+通过 Spring AI MCP 的 starter 可以和 Spring 配合使用
03
权衡点
!需要 JDK 17 或更高版本
!README 主要是设计思路和链接,代码示例在独立的文档网站上
!异步 API 基于 Reactor,有一定学习成本;README 还说明公开 API 仍在向纯 Reactive Streams 接口迁移
!Spring Boot 支持在单独的 Spring AI 项目里,不在这个仓库中
04
维护状况检查
活跃检查日期: 2026-10-27
- 最近提交
- 2026-10-27
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 7
- 最新发布
- v2.2.0-M1 (2026-10-16)
- 未关闭 issue
- 294
- 近期 issue 至少有一条评论的比例
- 5/7
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #578 Add Primitive repository APIs (`ResourceRepository`, `ToolsRepository`, ... )20 条评论 · 2025-09-26
- #274 McpServerSession lifecycle doesn't support distributed services17 条评论 · 2025-05-28
- #902 Stabilize flaky test: McpCompletionTests.testCompletionErrorOnMissingContext14 条评论 · 2026-04-04
- #156 Optimization - avoid unnecessary payload copy when deserializing12 条评论 · 2025-04-14
- #1011 SEP-2575: Make MCP Stateless11 条评论 · 2026-06-06
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
05
兼容性
Java
运行时
已通过文档验证
Spring AI
集成
已通过文档验证
Jakarta Servlet
服务器传输
已通过文档验证
JDK HttpClient
客户端传输
已通过文档验证
Jackson
JSON序列化
已通过文档验证
Project Reactor
响应式编程
已通过文档验证
06
快速开始
1
$ ./mvnw clean install -DskipTests
07
使用场景
↳开发消费模型上下文协议服务器的Java应用程序
↳在Java中实现和配置自定义的模型上下文协议服务器
↳启动集成模型上下文协议支持的AI应用程序
↳构建非阻塞、流处理的AI应用程序
08
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧