MCP Server Demo Kut

🚀 MCP 服務器演示項目文檔

這是一個基於 Spring Boot 3.4.4 的 MCP（模型控制協議）服務示例項目，集成 Spring AI 工具鏈實現智能服務功能。項目包含基礎數值運算、天氣查詢等服務的實現模板，為開發者提供了便捷的開發基礎。

🚀 快速開始

環境要求

• JDK 17
• Maven 3.8+
• IDE（推薦 IntelliJ IDEA）

運行步驟

1. 克隆倉庫

git clone https://github.com/liqingdong/mcp-server-demo.git 

2. 構建項目

mvn clean install

3. 使用服務

3.1 使用 STDIO 模式

3.1.1 配置啟動命令

java -jar -Dspring.ai.mcp.server.stdio=true target/mcp-server-demo-0.0.1-SNAPSHOT.jar

3.1.2 使用支持 MCP 工具的客戶端，例如：Cherry Studio 進行測試

3.2 使用 SSE 模式

3.2.1 配置啟動命令（默認訪問地址為：http://localhost:8081/sse）

java -jar target/mcp-server-demo-0.0.1-SNAPSHOT.jar 

✨ 主要特性

1. 數字服務（NumberService）

• 奇偶數判斷
• 素數檢測（已實現）
• 擴展建議：可添加質因數分解、斐波那契計算等功能

2. 天氣服務（WeatherService）

• 天氣數據接口（當前使用隨機數偽代碼。實際應用需對接第三方 API，可參考 OpenWeatherMap API）

3. MCP 工具支持

• 使用 @Tool 註解將服務暴露為標準化工具
• 使用 @ToolParam 註解定義服務參數

📚 詳細文檔

項目結構

src
|-- main
|  |-- java
|  |  `-- cn
|  |    `-- liqingdong
|  |      `-- mcp
|  |        `-- server
|  |          |-- McpApplication.java
|  |          `-- service
|  |            |-- NumberService.java
|  |            `-- WeatherService.java
|  `-- resources
|    `-- application.yml
`-- test
  `-- java
    `-- cn
      `-- liqingdong
        `-- mcp
          `-- server
            |-- McpApplicationTest.java
            `-- SSEMcpTest.java
            `-- STDIOMcpTest.java

核心測試類

開發規範

1. 代碼風格：遵循統一的編碼規範
2. 註解使用：通過 @Tool 和 @ToolParam 註解暴露和定義服務參數
3. 測試覆蓋率：確保核心功能的充分測試

貢獻指南

1. 代碼提交：Fork 項目並提交 Pull Request
2. 問題反饋：在 Issues 中報告問題或建議改進

項目狀態

![ Shields 圖標位置 ]