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 許可證 發佈。