MCP Webmvc Server

🚀 Spring AI MCP 天氣服務服務器示例

這是一個藉助 Spring AI 框架搭建的示例天氣服務服務器。該項目展示瞭如何運用 Model Context Protocol (MCP) 協議，構建一個基於 Spring Boot 的天氣信息服務，為用戶提供基本的天氣信息查詢能力。

🚀 快速開始

項目構建

mvn clean install

此命令會下載所有依賴項並構建項目 JAR 文件。

項目運行

啟動服務器

java -jar target/spring-ai-mcp-weather-server-0.0.1-SNAPSHOT.jar

服務器啟動後，將在默認端口 8080 上運行，並提供 RESTful 接口。

訪問接口

• 基本信息接口：

  http://localhost:8080/api/health
  

• 天氣查詢接口：

  http://localhost:8080/weather?city=New%20York
  

✨ 主要特性

• 功能：提供基本的天氣信息查詢能力。
• 技術棧：採用 Spring Boot、Spring AI 和 MCP 協議。
• 目標：演示 MCP 服務器端的實現，涵蓋服務註冊、協議處理和客戶端交互。

📦 安裝指南

項目所需的 Maven 依賴如下：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.datgen</groupId>
        <artifactId>jackson-dataformat-csv</artifactId>
    </dependency>
    <dependency>
        <groupId>org.modelmapper</groupId>
        <artifactId>modelmapper</artifactId>
    </dependency>
</dependencies>

💻 使用示例

基礎用法

當訪問 /weather?city=New%20York 時，示例輸出如下：

{
  "temperature": 75,
  "condition": "晴朗",
  "humidity": 60,
  "windSpeed": 15
}

📚 詳細文檔

項目結構

spring-ai-mcp-weather-server/
├── src/main/java/
│   └── org.springframework.ai.mcp.sample.server/
│       ├── WeatherService.java          # 天氣查詢業務邏輯實現類
│       └── WeatherController.java       # 天氣查詢 RESTful 接口控制器
├── pom.xml                              # 項目依賴管理文件
└── README.md                            # 項目說明文檔

配置文件

項目提供了一個默認的 application.properties 文件，包含以下配置：

server.port=8080
logging.level.root=INFO

若需要自定義配置，可創建一個 application.yaml 或 application.properties 文件，並將其放入項目的 src/main/resources 目錄。

🔧 技術細節

1. WeatherService.java

package org.springframework.ai.mcp.sample.server;

import org.springframework.stereotype.Service;
import java.util.HashMap;
import java.util.Map;

@Service
public class WeatherService {
    public Map<String, Object> getWeather(String city) {
        Map<String, Object> result = new HashMap<>();
        try {
            // 示例邏輯：返回假設計數據
            if ("New York".equals(city)) {
                result.put("temperature", 75);
                result.put("condition", "晴朗");
                result.put("humidity", 60);
                result.put("windSpeed", 15);
            } else {
                result.put("error", "城市未找到");
            }
        } catch (Exception e) {
            result.put("error", "服務異常");
        }
        return result;
    }
}

2. WeatherController.java

package org.springframework.ai.mcp.sample.server;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class WeatherController {
    private final WeatherService weatherService;

    public WeatherController(WeatherService weatherService) {
        this.weatherService = weatherService;
    }

    @GetMapping("/weather")
    public Map<String, Object> getWeather(@RequestParam String city) {
        return weatherService.getWeather(city);
    }
}

擴展說明

服務擴展

• 可以通過實現不同的 WeatherService 類來支持更多城市或天氣數據源。
• 支持多語言響應（如英文、中文等）。

協議擴展

• MCP 協議支持多種數據格式，包括 JSON 和 CSV。
• 可以根據需求自定義響應內容和結構。