技术文档摘要

注意：此项目已毕业并迁移到MCP Java SDK和Spring AI MCP。请在那里查看！此仓库现已存档。

Java & Spring MCP

一组提供Java SDK和Spring框架集成的项目，用于模型上下文协议。 它使Java应用程序能够通过标准化接口与AI模型和工具进行交互，支持同步和异步通信模式。

📚 参考文档

对于全面指南和API文档，请访问Spring AI MCP参考文档。

<img src="mcp-docs/src/main/antora/modules/ROOT/images/spring-ai-mcp-clinet-architecture.jpg" width="600"> <img src="mcp-docs/src/main/antora/modules/ROOT/images/spring-ai-mcp-server-architecture.jpg" width="600">

项目

MCP Java SDK

模型上下文协议规范的Java实现。包括：

• 同步和异步的MCP客户端和MCP服务器实现
• 标准MCP操作支持（工具发现、资源管理、提示处理、结构化日志）。支持请求和通知处理。
• 基于Stdio和SSE的传输实现。

MCP传输

核心传输

• 基于Stdio的（StdioClientTransport，StdioServerTransport）进程间通信
• 基于Java HttpClient的SSE客户端（HttpClientSseClientTransport）HTTP流
• 基于Servlet的SSE服务器（HttpServletSseServerTransport）使用传统Servlet API的HTTP SSE服务器流

可选SSE传输

• WebFlux SSE传输 - 使用Spring WebFlux的响应式HTTP流（客户端和服务器）
• WebMvc SSE传输 - 基于Spring MVC的HTTP SSE传输（仅限服务器）。您可以使用核心HttpClientSseClientTransport传输作为SSE客户端。

Spring AI MCP

Spring集成模块提供了特定于Spring的功能：

• 与Spring AI函数调用系统的集成
• 对MCP客户端友好的Spring抽象
• 自动配置（正在进行中）

安装

在您的Maven项目中添加以下依赖项：

<!-- 核心MCP -->
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>mcp</artifactId>
</dependency>

<!-- 可选：WebFlux SSE传输 -->
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>mcp-webflux-sse-transport</artifactId>
</dependency>

<!-- 可选：WebMVC SSE传输 -->
<dependency>
    <groupId>-org.springframework.experimental</groupId>
    <artifactId>mcp-webmvc-sse-transport</artifactId>
</dependency>

<!-- 可选：Spring AI集成 -->
<dependency>
    <groupId>org.springframework.experimental</groupId>
    <artifactId>spring-ai-mcp</artifactId>
</dependency>

这是一个里程碑版本，不在Maven中央仓库中。 在POM中添加此仓库：

<repositories>
    <repository>
        <id>spring-milestones</id>
        <name>Spring Milestones</name>
        <url>https://repo.spring.io/milestone</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

更多信息请参阅依赖管理页面。

示例演示

在spring-ai-examples/model-context-protocol仓库中探索这些MCP示例：

• SQLite Simple - 展示了数据库与LLM的集成
• SQLite Chatbot - 与SQLite数据库交互的互动聊天机器人
• 文件系统 - 允许LLM与本地文件系统文件夹和文件进行交互
• Brave - 允许与Brave搜索引擎进行自然语言交互，执行互联网搜索。
• 主题公园API示例 - 展示如何使用Spring AI创建MCP服务器和客户端，暴露主题公园API工具
• Http SSE客户端+WebMvc SSE服务器 - 展示如何创建和使用具有不同能力的MCP WebMvc服务器和HttpClient客户端
• WebFlux SSE客户端+WebFlux SSE服务器 - 展示如何创建和使用具有不同能力的MCP WebFlux服务器和客户端
• HttpClient SSE客户端+Servlet SSE服务器 - 展示如何创建和使用具有不同能力的MCP Servlet SSE服务器和HttpClient SSE客户端

文档

• Java MCP SDK文档
  • 参考文档
• Spring集成文档

开发

• 从源码构建

mvn clean install

• 运行测试

mvn test

贡献

这是一个实验性的Spring项目。欢迎贡献！请：

1. 分叉仓库
2. 创建一个特性分支
3. 提交拉取请求

团队

• Christian Tzolov
• Dariusz Jędrzejczyk

链接

• GitHub仓库
• 问题跟踪器
• CI/CD

许可证

本项目根据Apache许可证2.0授权。