MCP Webmvc Server

🚀 Spring AI MCP Weather Server Sample

This is a sample weather service server created using the Spring AI framework. It demonstrates how to leverage the Model Context Protocol (MCP) to build a Spring Boot-based weather information service.

🚀 Quick Start

This project is a sample weather service server built with the Spring AI framework. It showcases how to use the Model Context Protocol (MCP) to construct a weather information service based on Spring Boot.

✨ Features

• Functionality: Provides basic weather information query capabilities.
• Technology Stack: Spring Boot, Spring AI, MCP Protocol.
• Objective: Demonstrates the implementation of the MCP server side, including service registration, protocol handling, and client interaction.

📦 Installation

Dependencies

The following are the Maven dependencies required for the project:

<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>

Project Build

mvn clean install

This will download all dependencies and build the project JAR file.

💻 Usage Examples

Starting the Server

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

After starting, the server will run on the default port 8080 and provide RESTful interfaces.

Accessing Interfaces

• Basic information interface:

  http://localhost:8080/api/health
  

• Weather query interface:

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

📚 Documentation

Project Structure

spring-ai-mcp-weather-server/
├── src/main/java/
│   └── org/springframework/ai/mcp/sample/server/
│       ├── WeatherService.java          # Implementation class for weather query business logic
│       └── WeatherController.java       # RESTful interface controller for weather query
├── pom.xml                              # Project dependency management file
└── README.md                            # Project documentation

Configuration Files

The project provides a default application.properties file with the following configurations:

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

If you need custom configurations, you can create an application.yaml or application.properties file and place it in the src/main/resources directory of the project.

Core Implementation

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 {
            // Example logic: Return assumed data
            if ("New York".equals(city)) {
                result.put("temperature", 75);
                result.put("condition", "晴朗");
                result.put("humidity", 60);
                result.put("windSpeed", 15);
            } else {
                result.put("error", "City not found");
            }
        } catch (Exception e) {
            result.put("error", "Service exception");
        }
        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);
    }
}

Example Output

When accessing /weather?city=New%20York, the example output is as follows:

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

Extension Instructions

1. Service Extension:

   • More cities or weather data sources can be supported by implementing different WeatherService classes.
   • Multi - language responses (such as English, Chinese, etc.) are supported.

2. Protocol Extension:

   • The MCP protocol supports multiple data formats, including JSON and CSV.
   • The response content and structure can be customized according to requirements.