Donts MCP Server Demo

🚀 MCP 服務器演示項目

本項目是基於 Spring Boot 的 Model Context Protocol (MCP) 服務器演示項目，提供了計算器、天氣查詢、數據模型和 API 接口工具等功能，能滿足多樣化的使用需求。

🚀 快速開始

前置條件

• JDK 17 或更高版本
• Maven 3.6 或更高版本
• 和風天氣 API 密鑰（用於天氣查詢功能）

配置

1. 克隆項目到本地。
2. 在 src/main/resources/application.yml 中配置和風天氣 API 密鑰。

構建與運行

# 編譯項目
mvn clean package

# 運行項目
java -jar target/donts-ai-0.0.1-SNAPSHOT.jar

✨ 主要特性

本項目是一個簡單的 MCP 服務器實現，使用 Spring Boot 和 WebFlux 構建，具備以下功能：

1. 計算器工具：可計算各種數學表達式，涵蓋基本運算（加減乘除）和複雜表達式計算。
2. 天氣查詢工具：能即時查詢指定城市的天氣信息。
3. 系統信息資源：提供操作系統版本、Java 運行時環境版本、應用程序運行時間和當前用戶信息等基礎信息。
4. 數據模型查找工具：根據用戶描述查找匹配的數據模型。
5. API 接口查找工具：依據數據模型查找對應的 API 接口。
6. API 執行工具：根據用戶輸入構造參數並調用實際接口。

🔧 技術細節

本項目採用的技術棧如下：

• Java 17
• Spring Boot
• Spring WebFlux
• Model Context Protocol (MCP)
• Server-Sent Events (SSE)

💻 使用示例

計算器工具

計算器工具可以處理各種數學表達式，包括基本運算（加減乘除）和複雜表達式計算。示例如下：

2 + 2
(3 * 4) / 2
sqrt(16) + 5

數據模型查找工具

數據模型查找工具可以根據用戶的描述或關鍵詞，搜索並返回匹配的數據模型。示例輸入如下：

{
  "description": "用於預測股票價格",
  "keywords": ["時間序列", "迴歸"]
}

API 接口查找工具

API 接口查找工具可以根據數據模型的名稱或功能，搜索並返回對應的 API 接口信息。示例輸入如下：

{
  "model_name": "用戶行為分析模型"
}

API 執行工具

API 執行工具可以根據用戶的請求參數，構造請求並調用相應的 API 接口。示例輸入如下：

{
  "url": "http://example.com/api",
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "name": "test",
    "value": "123"
  }
}

模擬數據案例

用戶模型

{
  "model_name": "用戶行為分析模型",
  "description": "用於分析用戶的點擊流數據",
  "version": "1.0.0"
}

訂單模型

{
  "model_name": "訂單預測模型",
  "description": "用於預測未來的訂單量",
  "version": "2.1.0"
}

📚 詳細文檔

API 端點

SSE 連接

• 端點：/sse
• 方法：GET
• 描述：建立 SSE 連接，用於接收服務器發送的事件。

消息發送

• 端點：/mcp/messages
• 方法：POST
• 描述：發送消息到 MCP 服務器。

🏗️ 系統架構

本項目的主要組件包括：

• MCP 服務器：負責處理客戶端請求和響應。
• 工具實現：包含計算器、天氣查詢、數據模型查找等功能模塊。
• API 接口：提供 RESTful API 服務，支持 SSE 事件推送。

🤝 貢獻指南

歡迎參與項目貢獻！請按照以下步驟操作：

1. Fork 本倉庫。
2. 創建您的特性分支 (git checkout -b feature/amazing-feature)。
3. 提交您的更改 (git commit -m 'Add some amazing feature')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 打開一個 Pull Request。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。