Sprint Boot Sample MCP Server

🚀 模型上下文協議（MCP）服務器示例實現 - 使用Spring Boot

本項目是一個基於Spring Boot實現的模型上下文協議（MCP）服務器示例。該服務器可與MCP檢查程序配合使用，用於測試和調試。它提供了簡單的REST API與服務器交互，同時展示瞭如何搭建基礎的Spring Boot應用程序，還包含單元測試以驗證服務器功能。

🚀 快速開始

若要使用此MCP服務器，請按以下步驟操作：

1. 克隆倉庫

git clone https://github.com/your-repository.git
cd mcp-server

2. 構建項目 運行以下命令構建項目：

mvn clean install

3. 運行服務器 構建完成後，運行以下命令啟動服務器：

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

4. 測試API 使用curl或其他工具測試REST API。例如：

curl http://localhost:8080/api/test

✨ 主要特性

• 基於Spring Boot實現，為MCP服務器提供了簡單的REST API進行交互。
• 可與MCP檢查程序配合使用，方便進行測試和調試。
• 包含單元測試，能有效驗證服務器功能。
• 藉助MCP開放標準，讓AI模型可通過一致協議與各種工具交互。

📦 安裝指南

要求

• Java 17+版本
• Maven
• MCP檢查程序（可選，用於測試）

例如Claude桌面的配置

{
  "mcpServers": {
    "sample-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "sample-mcp-server-0.0.1-SNAPSHOT.jar",
        "--port",
        "8080",
        "--host",
        "localhost"
      ],
      "env": {
        "JAVA_TOOL_OPTIONS": "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005"
      }
    }
  }
}

⚠️ 重要提示

JAVA_TOOL_OPTIONS環境變量用於設置JVM選項以進行遠程調試。地址和端口可根據需要更改。

💻 使用示例

基礎用法

以下是使用curl測試REST API的示例：

curl http://localhost:8080/api/test

📚 詳細文檔

🧠 什麼是MCP？

模型上下文協議（MCP）是一個開放標準，定義了AI模型如何與外部工具和數據源通信。它為AI助手如Claude提供了訪問以下內容的標準方式：

• 🌐 即時信息
• 📊 自定義數據庫
• 🔄 API和服務
• 📁 文件系統

想象一下MCP就像“AI的USB標準”——它提供了一個通用接口，允許任何AI模型通過一致協議與各種工具交互。

使用Spring Boot的好處：

• 🔄 無縫集成：輕鬆將應用程序的功能暴露給AI助手
• 🛠️ 工具定義：使用簡單註解定義自定義工具
• 🚀 Spring Boot簡便性：利用Spring的依賴注入和配置管理
• 📈 增強的AI功能：讓AI模型訪問組織的即時數據和服務

開發

調試

安裝MCP檢查程序

npm -g install @modelcontextprotocol/inspector

運行MCP檢查程序進行測試

• 構建MCP服務器

mvn clean package

• 運行MCP檢查程序

npx @modelcontextprotocol/inspector -- sample-mcp-server.json

🔧 技術細節

模型上下文協議（MCP）作為開放標準，為AI模型與外部工具和數據源的通信提供了規範。本項目基於Spring Boot實現MCP服務器，藉助Spring的依賴注入和配置管理等特性，實現了服務器與MCP檢查程序的配合使用。通過簡單的REST API，方便與服務器進行交互，同時利用單元測試保證服務器功能的正確性。

📄 參考資料

Spring AI 延伸了 MCP Java SDK 的功能