Weather MCP Server

Weather MCP Server

Claude for Desktop を通じて気象情報を提供する Model Context Protocol（MCP）サーバーです。National Weather Service API と連携し、米国内の各地の天気予報や警報を提供します。MIT MCP Hackathon（2025年4月）の一環として作成されました。

機能

• get_forecast：緯度と経度を使って、米国内の任意の場所の詳細な天気予報を取得します
• get_alerts：州コードを使って、米国内の任意の州で発令中の気象警報を取得します

必要条件

• Python 3.10 以降
• uv パッケージマネージャー
• Claude for Desktop
• MCP SDK 1.2.0 以降

インストール

1. uv がインストールされていることを確認します：

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

2. Python 環境をセットアップします：

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx

設定

1. Claude for Desktop の設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json を作成または編集します：

{
  "mcpServers": {
    "weather": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/weather",
        "run",
        "weather.py"
      ]
    }
  }
}

2. /path/to/uv を uv の実行ファイルのパスに置き換えます（which uv を使って確認してください）
3. /absolute/path/to/weather をこのプロジェクトディレクトリの絶対パスに置き換えます

使い方

1. Claude for Desktop を起動します
2. ハンマー 🔨 アイコンを確認し、サーバーが接続されていることを確認します
3. 質問の例：
   • 「サクラメントの天気はどうですか？」
   • 「テキサス州で発令中の気象警報は何ですか？」

トラブルシューティング

• ~/Library/Logs/Claude/mcp*.log にある Claude のログを確認します
• 設定内のすべてのパスが絶対パスであることを確認します
• uv run weather.py を使って、サーバーが単独で動作することを確認します
• ポート 8001 が別のプロセスによって使用されていないことを確認します

API リファレンス

このサーバーは National Weather Service API を使用します：

• ベース URL：https://api.weather.gov
• 使用するエンドポイント：
  • /alerts/active/area/{state} - 州別に警報を取得します
  • /points/{lat},{lon} - 予報グリッドデータを取得します
  • /forecast - 詳細な天気予報を取得します

MIT MCP Hackathon について

このプロジェクトは、MIT MCP Hackathon（2025年4月）のチュートリアルの一環として作成されました。このハッカソンは、開発者に Model Context Protocol を紹介し、プロジェクトやスタートアップが独自の MCP サーバーを立ち上げる支援を目的としていました。このハッカソンは、MIT の NANDA（Networked Agents and Decentralized AI）ハブの取り組みの一環でした。

ライセンス

このプロジェクトは、Model Context Protocol のオリジナルチュートリアルに準拠しています

スクリーンショット