MCP Webmvc Server

🚀 Spring AI MCP 天気サーバーサンプル

このプロジェクトは、Spring AI フレームワークを使用して作成されたサンプル天気サービスサーバーです。Model Context Protocol (MCP) プロトコルを利用し、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>

プロジェクトのビルド

以下のコマンドを実行して、すべての依存関係をダウンロードし、プロジェクトの JAR ファイルをビルドします。

mvn clean install

💻 使用例

基本的な使用法

サーバーの起動

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
  

高度な使用法

カスタム設定

プロジェクトにはデフォルトの application.properties ファイルが用意されており、以下の設定が含まれています。

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

カスタム設定が必要な場合は、application.yaml または application.properties ファイルを作成し、プロジェクトの src/main/resources ディレクトリに配置します。

📚 ドキュメント

プロジェクト構造

spring-ai-mcp-weather-server/
├── src/main/java/
│   └── org/springframework/ai/mcp/sample/server/
│       ├── WeatherService.java          # 天気照会のビジネスロジック実装クラス
│       └── WeatherController.java       # 天気照会の RESTful インターフェースコントローラー
├── pom.xml                              # プロジェクトの依存関係管理ファイル
└── README.md                            # プロジェクトの説明ドキュメント

コア実装

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
}

拡張説明

サービス拡張

• 異なる WeatherService クラスを実装することで、より多くの都市や天気データソースをサポートできます。
• 多言語応答（英語、中国語など）をサポートします。

プロトコル拡張

• MCP プロトコルは、JSON や CSV などの複数のデータ形式をサポートしています。
• 必要に応じて、応答内容と構造をカスタマイズできます。

🔧 技術詳細

このプロジェクトは、Spring Boot と Spring AI を使用して構築されており、MCP プロトコルを利用して天気情報サービスを提供します。WeatherService クラスは天気照会のビジネスロジックを実装し、WeatherController クラスは RESTful インターフェースを提供します。

📄 ライセンス

原文書にライセンス情報が記載されていないため、このセクションは省略されています。