Weather MCP

🚀 天気 MCP サービス

このサービスは、Model Control Protocol (MCP) に基づく天気情報サービスです。天気予報と警報の照会機能を提供します。

✨ 主な機能

• 米国各州の天気警報を取得する（get_alerts）
• 緯度と経度を使って天気予報を照会する（get_forecast）

🔧 技術詳細

• Python 3.11+
• MCP (Model Control Protocol)
• FastMCP サーバー
• LangGraph + LangChain
• SSE (Server-Sent Events) 伝送

📦 インストール

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

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

2. 仮想環境を作成します：

   # Python 標準ライブラリを使用
   python -m venv weather_venv
   
   # 仮想環境をアクティブ化（Windows）
   weather_venv\Scripts\activate
   
   # 仮想環境をアクティブ化（Linux/Mac）
   source weather_venv/bin/activate
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

4. 環境変数を設定します：

   • .env ファイルを作成し、.env.example ファイルの形式を参考にします。
   • 必要な API キーを追加します。

💻 使用例

基本的な使用法

1. Weather サーバーを起動します：

   python weather/weather.py
   

   サーバーは http://localhost:8000 で起動し、SSE 伝送を使用します。

2. 別のターミナルウィンドウでクライアントを実行します：

   python weather/mcp_client.py
   

   クライアントはサーバーに接続し、一連の天気照会テストを実行します。

📚 ドキュメント

天気警報照会

get_alerts(state: str) -> str

• state: 2 文字の米国州コード（例: CA, NY）
• 戻り値: その州のアクティブな天気警報のリスト

天気予報照会

get_forecast(latitude: float, longitude: float) -> str

• latitude: 位置の緯度
• longitude: 位置の経度
• 戻り値: その位置の天気予報

🔍 プロジェクト構造

weather-mcp/ ├── weather/ │ ├── weather.py # メインサーバーファイル │ ├── mcp_client.py # クライアントテストファイル ├── requirements.txt # プロジェクトの依存関係 ├── .env.example # 環境変数のサンプル └── README.md # このドキュメント

📄 環境変数の設定

プロジェクトは .env ファイルを使用して環境変数と機密情報を保存します。以下の手順で設定してください。

1. 環境変数のテンプレートファイルをコピーします：

   cp .env.example .env
   

2. .env ファイルを編集し、実際の設定を入力します：