Weather CLI App

天気 CLI アプリ

Model Context Protocol（MCP）を使用して、米国国立気象局の API から気象警報と天気予報を取得するシンプルなアプリケーションです。

機能

• 米国の任意の州について、有効な気象警報を取得
• 座標を指定して、任意の地点の天気予報を取得
• AI アシスタントとの連携に対応した MCP サーバーの実装

インストール

1. Python 3.11 以上がインストールされていることを確認します
2. このリポジトリをクローンします
3. pip でパッケージをインストールします：

# Install with pip
pip install -e .

# Or if you have pip3 specifically
pip3 install -e .

注：このプロジェクトは MCP フレームワークを使用しており、ロックファイルの記載内容にかかわらず、uv ツールは特に必要ありません。

MCP サーバーとしての使用方法

インストールすると、Model Context Protocol に対応した AI アシスタントから天気 MCP サーバーにアクセスできます。サーバーは主に次の 2 つのツールを提供します：

1. get_alerts - 米国の州（2 文字の州コードを使用）の気象警報を取得します
2. get_forecast - 指定した座標（緯度、経度）の天気予報を取得します

開発

このプロジェクトでは、次のものを使用しています：

• 非同期 HTTP リクエスト用の httpx
• 構造化データ処理用の MCP サーバーツール

トラブルシューティング

ログに spawn uv ENOENT のようなエラーが表示される場合：

1. uv ではなく pip でパッケージをインストールしたことを確認します
2. Python 環境が正しく設定されていることを確認します
3. サーバーを手動で実行し、追加の stderr 出力を確認します：python -m weather

API 情報

このアプリケーションは、気象データの取得に米国国立気象局（NWS）の API を使用します。API キーは不要ですが、レート制限を尊重してご利用ください。