Jackkuo666 Weather MCP Server

🚀 天気 MCP サーバー

このサーバーは、国家気象局（NWS）の API を使用して天気情報を提供するモデルコンテキストプロトコル（MCP）サーバーです。天気警報や天気予報の取得が可能で、様々なアプリケーションに組み込むことができます。

🚀 クイックスタート

このサーバーを使用するには、まず必要な環境をセットアップし、サーバーを起動する必要があります。以下の手順に従って操作してください。

✨ 主な機能

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

📦 インストール

必要条件

• 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 のドキュメントを参照してください。

エラー処理とログ記録

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

テスト

単体テスト

単体テストを実行するには、以下のコマンドを実行します。

python -m unittest test_weather.py

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

手動テスト

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

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

# サンフランシスコの予報を取得
result = await mcp.call_tool("get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

🔧 技術詳細

サーバーは Python で構築されており、FastMCP と httpx を使用して NWS API と通信しています。エラー処理とログ記録は、サーバーの安定性とデバッグの容易性を向上させるために実装されています。

📄 ライセンス

このプロジェクトは [LICENSE] ライセンスの下で提供されています。詳細については、リポジトリ内のライセンスファイルを参照してください。

コントリビューション

このプロジェクトへのコミュニティからの貢献を歓迎します！何か質問、提案、または機能要求がある場合は、自由にイシューを作成してください。