Weather MCP Server

Weather MCP Server

Model Context Protocol（MCP）を通じて気象情報を提供する Spring Boot アプリケーションです。このプロジェクトでは、Spring AI を使用して MCP サーバーを作成し、AI アシスタントが利用できるツールとして気象データを公開する方法を紹介します。

📋 目次

• 概要
• 機能
• 技術
• プロジェクト構成
• 前提条件
• インストール
• アプリケーションの実行
• MCP Inspector の使用
• API ドキュメント
• コントリビューション
• ライセンス

🔍 概要

このプロジェクトは、さまざまな場所のモック気象データを提供する気象サービスを実装しています。この機能を Model Context Protocol（MCP）を通じて公開することで、AI アシスタントが指定された場所の気象情報を取得できるようにします。

✨ 機能

• 任意の場所の現在の気象情報を取得
• 現実的なパラメーターを使ったモック気象データの生成
• AI アシスタントとの互換性を実現する MCP 統合
• 簡単にセットアップおよび設定できる Spring Boot アプリケーション

🛠️ 技術

• Java 17
• Spring Boot 3.2.0
• Spring AI MCP Server
• Maven
• Lombok

📁 プロジェクト構成

src/
├── main/
│   ├── java/
│   │   └── com/
│   │       └── gox/
│   │           └── weather/
│   │               ├── WeatherMcpApplication.java    # Main application class
│   │               ├── model/
│   │               │   └── WeatherData.java          # Weather data model
│   │               └── service/
│   │                   └── WeatherService.java       # Weather service with MCP tool
│   └── resources/
│       └── application.properties                    # Application configuration

📋 前提条件

• Java 17 以上
• Maven 3.6 以上
• Node.js および npm（MCP Inspector 用）

🚀 インストール

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/weather-mcp-java.git
   cd weather-mcp-java
   

2. プロジェクトをビルドします：

   mvn clean install
   

🏃‍♂️ アプリケーションの実行

Spring Boot アプリケーションを起動します：

mvn spring-boot:run

アプリケーションはデフォルトでポート 8080 で起動します（application.properties で変更できます）。

⚙️ IDE ツールでの MCP の設定

Cursor や Cline などの IDE ツールで AI アシスタントからこの MCP サーバーを使用するには：

1. AI アシスタント設定を行う IDE の設定を開きます
2. MCP または Model Context Protocol の設定を探します
3. 次の SSE エンドポイントを使って新しい MCP サーバーを追加します：

   http://localhost:8089/sse
   

4. 設定を保存し、必要に応じて AI アシスタントを再起動します
5. AI アシスタントで天気ツールを使用できるようになります

注：ポート（8089）が application.properties ファイルで設定されているポートと一致していることを確認してください。

🔧 MCP Inspector の使用

MCP Inspector は、MCP サーバーのテストとデバッグを行うためのツールです（MCP サーバーをデバッグする場合に使用します）。使用方法は次のとおりです：

1. MCP Inspector をインストールして実行します：

   npx @modelcontextprotocol/inspector
   

2. ブラウザーで MCP Inspector を開きます：

   http://127.0.0.1:6274/#tools
   

3. SSE エンドポイントを入力して、MCP サーバーに接続します：

   http://localhost:8080/mcp/sse
   

   注：ポート（8080）は、Spring Boot アプリケーションが実行されているポートと一致している必要があります。

4. 接続後、場所のパラメーターを指定して getWeather ツールをテストできます。

📚 API ドキュメント

Weather Service

Weather Service は次の機能を提供します：

天気の取得

指定した場所の気象情報を返します。

ツール名：getWeather

パラメーター：

• location（String）：気象情報を取得する場所の名前（例：「New York」、「London」、「Tokyo」）

レスポンス：

{
  "location": "New York",
  "temperature": 22.5,
  "condition": "Partly Cloudy",
  "humidity": 65,
  "windSpeed": 12.3
}

🤝 コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。