Server2mcp Spring Boot Starter

🚀 Server2MCP Spring Boot Starter

Server2MCP Spring Boot Starter 是一个用于自动化集成 MCP（模型控制协议）服务的 Spring Boot 启动器，它能自动配置 MCP 服务，非侵入式地增强功能，支持 JavaSdk 中 MCP 的所有原生功能，还允许用户自定义工具解析。

🚀 快速开始

由于该项目尚未推送到中央仓库，您可以下载源代码，执行 mvn clean install，然后进行依赖引用。

添加依赖

在 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.ai.plug</groupId>
    <artifactId>server2mcp-spring-boot-starter</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

配置文件设置

在配置文件中添加如下配置：

properties 文件

plugin.mcp.enabled=true

yml 文件

plugin:
  mcp:
    enabled: true

上述是启动项目的最基本配置，包含 spring.ai.mcp.server-side 等所有原生配置。默认情况下，它会将您启动类路径下的所有控制器注册为 MCP 接口。如果接口方法或类上带有 @Deprecated 注解，则不会进行注册。

✨ 主要特性

• 自动配置：自动配置 MCP 服务，类似于 MyBatis Plus 与 MyBatis 的关系，非侵入式，纯粹增强功能。
• 原生功能支持：支持 JavaSdk 中 MCP 的所有原生功能，提供工具注册和回调机制等。
• 自定义工具解析：支持自定义工具解析，用户可以自定义 Parser，无需依赖责任链实现完成唯一接口注解的属性解析。

📚 详细文档

可以理解为对外开放接口给 AI，这些接口与普通接口相同，只是可以通过 AI 调用。相关知识文档如下：

• 模型上下文协议（MCP）:: Spring AI 参考
• [简介 - 模型上下文协议](https://docs.spring.io/spring-ai/reference/api/mcp/mcp-overview.html）
• 简介 - 模型上下文协议

💕 最佳实践

有了这个框架，您不再需要从头开始重建一个 MCP 服务应用，也不需要在高度耦合的复制代码上添加 @Tool 注解，或向源码中添加 MCP 功能。您只需基于配置类轻松添加自定义的 @ToolScan 注解，即可完成 MCP 接口的注册。

• 构建多代理应用：您可以轻松构建一个多代理应用，通过使用多个您自定义的 AI 对话接口，然后在客户端上简单调用相应的 MCP 接口即可。
• 为管理系统添加 AI 对话调用：它可以快速为您的管理系统访问 AI 对话调用，具有高度定制性。您无需关注 AI 领域的任何细节，只需专注于自己喜欢的后端和前端领域，就可以实现酷炫效果。与之相比，像 DB - GPT 这样的应用可能会显得笨重且难以扩展。
• 接口调试：可以配合简单的 MCP 客户端如 Cursor 轻松完成接口调试。

👀 未完成点

SpringAI 中还有很多待集成的解析扩展点。例如，目前只完成了 Javadoc 版本的注解，但解析架构使用了责任链和模板，极其容易扩展。未来将整合各种主流方法来描述注解解析。

🔔 总结

这个框架实际上非常简单，代码中可能存在许多漏洞和不足，请多多包涵。

📄 许可证

本项目代码根据 Apache 2.0 许可证 发布。