Weather MCP Server Y38

🚀 天気 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を使用して構築され、国家気象局（NWS）API を利用して天気情報を提供します。

✨ 主な機能

• アメリカの特定の州の天気警報を取得する
• 緯度と経度に基づいて特定の位置の天気予報を取得する

📦 インストール

必要条件

• Python 3.10+
• FastMCP
• httpx

インストール手順

1. このリポジトリをクローンします。
2. 仮想環境を設定します。

   python -m venv .venv
   source .venv/bin/activate  # Windowsの場合は `.venv\Scripts\activate` を使用
   

3. uv を使用して必要なパッケージをインストールします。

   uv add "mcp[cli]" httpx
   

📚 ドキュメント

設定

サーバーは config.py という設定ファイルを使用しており、以下の設定が含まれています。

これらの設定は config.py ファイルで変更することができ、サーバーの動作をカスタマイズできます。

使用方法

独立したサーバーとして実行する場合

1. 仮想環境がアクティブでない場合は、まずアクティブにします。

   source .venv/bin/activate  # Windowsの場合は `.venv\Scripts\activate` を使用
   

2. サーバーを実行します。

   python weather.py
   

Cline と組み合わせて使用する場合

天気 MCP サーバーは Cline の設定に追加されています。Cline で使用するには：

1. Cline が正しく設定され、実行されていることを確認してください。
2. 天気 MCP サーバーはツール “weather” として利用可能です。
3. Cline で以下のツールを使用できます。 a. get_alerts(state: str)：アメリカの特定の州の天気警報を取得します（2 文字の州コードを使用します。例：“CA” はカリフォルニア州を表します） b. get_forecast(latitude: float, longitude: float)：緯度と経度に基づいて特定の位置の天気予報を取得します。

Cline での使用例：

# カリフォルニア州の警報を取得する
result = await mcp.call_tool("weather.get_alerts", state="CA")
print(result)

# サンフランシスコの予報を取得する（近似座標）
result = await mcp.call_tool("weather.get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

注意：Cline で MCP ツールを呼び出す具体的な構文は、Cline の設定によって異なる場合があります。最新の使用方法については、Cline のドキュメントを参照してください。

🔧 技術詳細

エラー処理とログ記録

サーバーは API リクエストのエラー処理とログ記録機能を改善しています。リクエスト中にエラーが発生した場合、サーバーはエラーを記録し、適切なエラーメッセージを返します。ログは設定されたログレベルとフォーマットに従ってコンソールに出力されます。

テスト

単体テスト

単体テストを実行するには：

python -m unittest test_weather.py

これらのテストは get_alerts と get_forecast ツールの基本機能をカバーしています。

手動テスト

サーバーを手動でテストする場合は、MCP クライアントを使用して提供されるツールを呼び出すことができます。以下はいくつかのサンプルコマンドです。

# カリフォルニア州の警報を取得する
result = await mcp.call_tool("weather.get_alerts", state="CA")
print(result)

# サンフランシスコの予報を取得する（近似座標）
result = await mcp.call_tool("weather.get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

📄 ライセンス

未提供

貢献者

• [あなたの名前]