Spring AI MCP Weather Server Sample 中文文档

项目概述

这是一个使用 Spring AI 框架创建的示例天气服务服务器。该项目展示了如何利用 Model Context Protocol (MCP) 协议来构建一个基于 Spring Boot 的天气信息服务。

• 功能：提供基本的天气信息查询能力。
• 技术栈：Spring Boot, Spring AI, MCP 协议。
• 目标：演示 MCP 服务器端的实现，包括服务注册、协议处理和客户端交互。

项目结构

spring-ai-mcp-weather-server/
├── src/main/java/
│   └── org/springframework/ai/mcp/sample/server/
│       ├── WeatherService.java          # 天气查询业务逻辑实现类
│       └── WeatherController.java       # 天气查询 RESTful 接口控制器
├── pom.xml                              # 项目依赖管理文件
└── README.md                            # 项目说明文档

依赖项

以下是项目所需的 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>

项目构建

mvn clean install

这将下载所有依赖项并构建项目 JAR 文件。

项目运行

启动服务器

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

启动后，服务器将在默认端口 8080 上运行，并提供 RESTful 接口。

访问接口

可以通过以下 URL 测试服务：

• 基本信息接口：

  http://localhost:8080/api/health
  

• 天气查询接口：

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

配置文件

项目提供了一个默认的 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);
    }
}

示例输出

当访问 /weather?city=New%20York 时，示例输出如下：

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

扩展说明

1. 服务扩展：

   • 可以通过实现不同的 WeatherService 类来支持更多城市或天气数据源。
   • 支持多语言响应（如英文、中文等）。

2. 协议扩展：

   • MCP 协议支持多种数据格式，包括 JSON 和 CSV。
   • 可以根据需求自定义响应内容和结构。

项目目标

• 演示 Spring AI 框架在 MCP 协议中的使用。
• 提供一个可扩展的天气信息服务实现。
• 展现微服务架构下的协议处理能力。