MCP Java SDK：为 Java 应用提供 Model Context Protocol 的官方客户端与服务器 SDK

modelcontextprotocol/java-sdk · The official Java SDK for Model Context Protocol servers and clients. Maintained in collaboration with Spring AI

GitHub原文发布未知首次收录 2026-09-27上架 2026-09-27 07:01

☆ 收藏查看项目 ↗

ELI5：它是什么，解决什么问题

这是 Model Context Protocol（MCP）的官方 Java SDK，由官方与 Spring AI 协作维护，用于让 Java 应用通过标准化接口与 AI 模型和工具交互。它同时支持客户端和服务器两种角色，涵盖同步与异步通信模式，核心模块包含 STDIO、JDK HttpClient 与 Servlet 传输，并提供可插拔的 JSON 序列化实现。

# Spring AI # SDK # 开发框架 # Spring Boot

核心能力与快速开始

★ 3712 · Java

能做什么: 提供 MCP 协议在 Java 生态的集成能力，支持 Java 应用作为客户端消费 MCP 服务器，或作为服务器对外暴露 MCP 端点；支持同步与异步（Reactive Streams）编程模型，异步部分以 Project Reactor 为实现并提供同步门面；传输层客户端默认使用 JDK HttpClient，服务器核心使用 Jakarta Servlet；JSON 绑定抽象默认由 Jackson 实现，可替换；服务器提供可插拔的授权钩子；通过 SLF4J 记录日志并借助 Reactor Context 传播可观测性上下文。模块划分包括 mcp-bom、mcp-core、mcp-json-jackson2、mcp-json-jackson3、mcp 汇合包与 mcp-test。
适用场景: 适用于需要在 Java 应用中接入 MCP 以连接 AI 模型与工具的场景，例如构建 MCP 客户端以调用外部 MCP 服务器、实现并配置 MCP 服务器对外提供工具能力，以及在 Spring 生态中结合 Spring AI 的客户端与服务器 starter、MCP 注解与安全支持来搭建带 MCP 能力的 AI 应用。
项目形态: 开发框架
部署方式: 未说明
主要依赖: 需要 Java 17 及以上版本；从源码构建使用 Maven Wrapper；运行测试需预先安装 Docker 与 npx；一致性测试需要 npx。
使用限制: SDK 自身不包含日志后端，也不提供指标与追踪实现；服务器授权仅提供可插拔钩子，不内置授权系统；Spring 相关集成已移至 Spring AI 2.0+，不在本仓库内；客户端一致性测试与 Auth 一致性测试并非全部通过；部署条件、硬件与 API 成本未说明。
许可证: MIT
最近推送: 2026-09-23 20:14

官方入门项目文档核对 README 依据 ↗

资料检查：2026-09-27 07:00 · 卡片整理：2026-09-27 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

Java 程序员可以使用该 SDK 在 Java 应用中集成 MCP 客户端或服务器，通过标准化接口与 AI 模型和工具交互，支持同步与异步通信模式，并利用 STDIO、JDK HttpClient 与 Servlet 传输以及可插拔的 JSON 序列化实现来构建 AI 集成功能。

查看内容依据

This SDK enables Java applications to interact with AI models and tools through a standardized interface, supporting both synchronous and asynchronous communication patterns.

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

相似资源

Spring AI AgentCore SDK：将 Amazon Bedrock AgentCore 能力集成到 Spring AI

一个开源 Java 库，通过注解、自动配置和可组合的 advisor 等 Spring 风格模式，把 Amazon Bedrock AgentCore 的能力引入 Spring AI。提供 Runtime Starter（自动配置 /invocations 与 /ping 端点、SSE 流式、健康检查、限流）、Identity（工作负载令牌、API Key、OAuth 2.0 凭证与响应式传播）、Memory（短期与长期记忆）、Browser（基于 Playwright 的网页导航、内容提取、截图、表单交互）、Code Interpreter（安全的 Python/JavaScript/TypeScript 执行与文件获取）、Artifact Store（会话级、基于 TTL 的生成文件存储）、Common 与 BOM 等模块，并附带多个示例与 Terraform 基础设施即代码，支持部署到 AgentCore Runtime 或独立运行。

ai-recruitment-agent：AI 辅助招聘平台，为 HR 与求职者提供 CV 结构化与评分服务

一个基于 Spring Boot 与 React 的全栈招聘平台，面向 HR 和求职者两类用户。系统内的 AI 负责三件事：将 CV 抽取为结构化数据、按 HR 自定义的 rubric 逐项打分、对分数给出解释并附 CV 引用。AI 不负责加权汇总、排名或录取决定，这些交给后端基于显式权重的计算与 HR 的最终判断。技术栈包括 Java 25、Spring Boot 4.1、Spring AI 2.0（Anthropic 对话、OpenAI 嵌入、PgVector 向量库）、PostgreSQL 17 + pgvector、React 19 与 Vite。项目目前处于初始化阶段，尚未实现任何功能。

Spring AI：面向 AI 工程开发的 Spring 风格应用框架

Spring AI 为 Java/Spring 生态提供了一套 Spring 友好的 API 与抽象，用于开发 AI 应用。它将 Spring 的可移植性和模块化设计原则引入 AI 领域，核心目标是连接企业数据与 API 同 AI 模型。框架支持多家主流 AI 模型提供商（Anthropic、OpenAI、Amazon Bedrock、Google、Ollama、Mistral AI、DeepSeek 等）及多种模型类型（对话、嵌入、文生图、音频转录、文本转语音、内容审核），提供可移植的同步与流式 API、结构化输出、向量存储集成、工具调用、可观测性、ETL 文档注入管道、模型评估、ChatClient 与 Advisors API、MCP 支持、对话记忆与 RAG，以及 Spring Boot 自动配置和 Starters。

Spring AI Session：为 Spring AI 应用提供事件溯源式会话记忆与上下文压缩

Spring AI Session 是一个 Spring AI 库，为 AI 应用提供结构化、事件溯源的会话管理能力。它把每条消息建模为带身份、时间戳、会话归属和可选分支标签的 SessionEvent，支持在历史过长时按轮次边界触发上下文压缩（compaction），并通过 SessionRepository SPI 在内存、JDBC（PostgreSQL、MySQL、MariaDB、H2）等后端之间切换。配合 SessionMemoryAdvisor 接入 ChatClient 后，调用会自动加载历史、追加消息并在需要时压缩，还包含事件过滤、多智能体分支隔离与跨会话召回等文档主题。

这是基于来源内容整理的摘要。原文链接失效后，本页摘要和讨论仍会保留。