weather-mcp

weather-mcp

AI アシスタント、Claude、Gemini CLI、または MCP 互換クライアントが、単に生の数値を取得するのではなく、リアルタイムのデータを使って実際の天気に関する質問に回答できるようにする MCP（Model Context Protocol）サーバーです。

Open-Meteo を利用しています。無料で、API キーは不要です。

単なる生の天気 API ラッパーではない理由

ほとんどの天気連携は temperature: 22°C のような情報を返すだけです。このツールはその上に推論レイヤーを追加しているため、通常の API では直接答えられない質問にも対応できます。

• get_weather("Bangalore") — 現在の天気と今日の予報
• should_i_carry_umbrella("Mumbai") — 降水確率だけでなく、理由も添えたはい／いいえの回答
• is_good_for_outdoors("Delhi") — 雨、風、気温をまとめて確認し、屋外で過ごすのに適した日かどうかを判断
• compare_weather("Bangalore", "Delhi") — 2 つの都市の天気を一度に比較

セットアップ

git clone https://github.com/darshan0548/weather-mcp.git
cd weather-mcp
python3 -m venv venv
source venv/bin/activate   # on Windows: venv\Scripts\activate
pip install -r requirements.txt

テストの実行

実際の API に対する簡単な動作確認です（モックも API キーも不要です）。

python test_weather.py

Claude Desktop への接続

Claude Desktop の設定（claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["/absolute/path/to/weather-mcp/server.py"]
    }
  }
}

Gemini CLI への接続

~/.gemini/settings.json に以下を追加します。

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["/absolute/path/to/weather-mcp/server.py"]
    }
  }
}

クライアントを再起動してから、「今日、チェンナイでは傘を持っていくべき？」のように質問してください。

プロジェクト構成

weather_core.py     # talks to the Open-Meteo API, no MCP-specific code
weather_advice.py    # reasoning layer built on top of raw weather data
server.py            # MCP server — wires the above into tools
test_weather.py       # sanity tests against the real API

意図的にファイルを分けています。weather_core.py と weather_advice.py は MCP にまったく依存していないため、単独で簡単にテストしたり再利用したりできます。

コントリビューション

プルリクエストを歓迎します。ツールを追加したい場合は、以下のアイデアを参考にしてください。

• 今日の概要だけでなく、時間ごとの予報の内訳
• 大気質データ（Open-Meteo には無料のエンドポイントもあります）
• 複数日にわたる旅行の計画（屋外イベントに最適な曜日を今週の中から選ぶ）
• 悪天候に関する警報

生データに推論を加える新しいツールは weather_advice.py に、データの取得だけを行うツールは weather_core.py に追加し、新しい @mcp.tool() として server.py に接続してください。

ライセンス

MIT — LICENSE を参照してください。