MCP Server Spring Java

🚀 使用 Spring Boot Java 實現的 MCP 服務器

本項目是一個基於 Spring Boot 和 Java 21 實現的 Model Context Protocol (MCP) 服務器，它展示瞭如何創建一個能夠提供 AI 助手用戶管理工具的 MCP 服務器，為相關開發提供了實用的範例。

✨ 主要特性

• 功能實現：藉助 Spring AI 實現 MCP 服務器的核心功能。
• 用戶管理：通過 MCP 接口提供豐富的用戶管理工具。
• 通信模式：支持同步通信模式，保障數據交互的穩定性。
• 傳輸方式：支持標準 I/O 和 Server-Sent Events (SSE) 兩種傳輸方式，滿足不同場景需求。
• 數據交互：集成 DummyJSON 外部 API 進行用戶數據的交互。

📦 安裝指南

先決條件

• Java 21 或更高版本
• Maven

安裝步驟

1. 克隆倉庫

git clone https://github.com/yourusername/mcp-spring-java.git
cd mcp-spring-java

2. 構建項目

mvn clean package

3. 運行應用程序

java -jar target/mcp-spring-java-0.0.1-SNAPSHOT.jar

📚 詳細文檔

配置信息

MCP 服務器在 application.yml 中進行配置，具體信息如下：

• 服務器運行端口：8090
• 服務器名稱：my-dummy-users-server
• 通信模式：同步通信模式
• 支持終端基於標準 I/O 的通信
• 提供 /mcp/message 端點用於 SSE 通信

可用工具

服務器公開了以下用戶管理工具：

• getAllUsers - 獲取所有用戶（帶分頁）
• getAllUsersDefault - 獲取所有用戶（默認分頁）
• getUserById - 根據 ID 獲取單個用戶
• searchUsers - 搜索用戶（根據查詢條件）
• addUser - 添加新用戶
• updateUser - 更新用戶信息
• deleteUser - 刪除用戶

使用 Postman 測試

可以使用 Postman 對 MCP 服務器端點進行測試，具體步驟如下：

1. 啟動 MCP 服務器。
2. 打開 Postman 並創建一個新的請求：
   • 方法：POST
   • URL：http://localhost:8090/mcp/message
   • 請求頭：
     • Content-Type: application/json
     • Accept: application/json
3. 對於請求正文，使用以下 JSON 格式調用任何可用工具：

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "[TOOL_NAME]",
        "parameters": {
          "[PARAMETER_NAME]": "[PARAMETER_VALUE]"
        }
      }
    ]
  }
}

示例請求

獲取所有用戶（默認分頁）

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getAllUsersDefault",
        "parameters": {}
      }
    ]
  }
}

根據 ID 獲取用戶

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "getUserById",
        "parameters": {
          "id": 1
        }
      }
    ]
  }
}

搜索用戶

{
  "message": {
    "toolCalls": [
      {
        "id": "call-123",
        "name": "searchUsers",
        "parameters": {
          "query": "example"
        }
      }
    ]
  }
}

📄 許可證

本項目使用 Apache License 2.0 許可證。