MCP Weather

MCP Weather

Model Control Protocol（MCP）フレームワークで構築された、National Weather Service（NWS）のデータにアクセスできる気象情報サービスです。

概要

MCP Weather は、MCP ツールとして機能する Python アプリケーションです。AI アシスタントが National Weather Service API からリアルタイムの気象情報にアクセスできます。このサービスでは、主に次の 2 つの機能を利用できます。

1. 気象警報：米国の任意の州で発令中の気象警報を取得します
2. 気象予報：緯度と経度を指定して、米国内の任意の場所の詳細な気象予報を取得します

機能

• 米国の州コードを指定して、発令中の気象警報を取得します
• 特定の場所の詳細な気象予報を取得します
• 読みやすいように整形された、すっきりとした出力
• AI アシスタントとシームレスに統合できる MCP ツールとして構築されています

要件

• Python 3.13 以降
• 依存関係：
  • httpx
  • mcp[cli]

インストール

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

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

2. サーバーを実行するには、Python パッケージマネージャーの uv が必要です

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

使い方

MCP サービスとして実行する

サーバーをテストするには、次を実行します

uv run weather.py

サーバーがエラーなく正常に実行されたら、次のコマンドでツールを利用可能にできます：

PATH/uv --directory ABSOLUTE_PATH/mcp-weather run weather.py

利用可能なツール

気象警報を取得

指定した米国の州で発令中の気象警報を取得します。

パラメーター：

• state：米国の州を表す 2 文字のコード（例：CA、NY）

気象予報を取得

指定した場所の詳細な気象予報を取得します。

パラメーター：

• latitude：場所の緯度
• longitude：場所の経度

API リファレンス

このアプリケーションは、気象データの取得に National Weather Service API を使用します。

コントリビューション

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

謝辞

• 気象データ API を提供している National Weather Service
• AI ツールとの統合を可能にする MCP フレームワーク
• Model context protocol のドキュメント：https://modelcontextprotocol.io/quickstart/server#test-with-commands