Claudeデスクトップ用天気MCPツール

Claude Desktop 用に特別に設計された、OpenWeatherMap API を使用してリアルタイムの気象データ、予報、気象履歴情報を提供する MCP (Model Context Protocol) ツールです。

チュートリアル

このツールの設定と使用に関する詳細なガイドについては、包括的な Medium チュートリアルをご覧ください: チュートリアル: Claude Desktop と Weather MCP ツールを使って世界中のリアルタイム気象データにアクセスする

特徴

あらゆる場所のリアルタイムの気象状況
天気予報（最大5日間）
過去の気象データ（過去5日間）
大気質情報
気象警報と注意報
場所検索機能

設定

Python 3.10以降がインストールされていることを確認してください
依存関係をインストールします:

pip install -r requirements.txt

OpenWeatherMapからAPIキーを取得する（無料版あり）
- 注: 新しいAPIキーが有効になるまでに最大24時間かかる場合があります
API キーの環境変数を設定します (推奨方法):
- プロジェクトディレクトリに.envファイルを作成する
- APIキーをファイルに追加します: GXP2
- 機密データのコミットを防ぐために、 .gitignoreファイルに.envを追加します。
環境変数を使用するようにmain.pyを更新します。
# Add these imports at the top import os from dotenv import load_dotenv # Load environment variables load_dotenv() # Replace the API_KEY line with API_KEY = os.getenv("OPENWEATHER_API_KEY")

Claude Desktopとの統合

次の内容を MCP 構成に追加して、Claude Desktop で MCP 設定を構成します。

{
  "mcpServers": {
    "weather-mcp": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Weather-MCP-ClaudeDesktop\\main.py"]
    }
  }
}

パスをmain.pyファイルへのフルパスに置き換えます。
次を使用してサーバーを実行します。

py -3.13 main.py

Claude Desktop の使用中はサーバーを実行したままにしてください

利用可能なツール

1. 現在の天気を取得する

特定の場所のリアルタイムの気象状況を取得します。

{
    "location": {
        "name": "New York",
        "country": "US",
        "lat": 40.7128,
        "lon": -74.006
    },
    "temperature": {
        "current": 25.6,
        "feels_like": 26.2,
        "min": 23.4,
        "max": 27.8
    },
    "weather_condition": {
        "main": "Clear",
        "description": "clear sky",
        "icon": "01d"
    },
    "wind": {
        "speed": 3.6,
        "deg": 220
    },
    "clouds": 5,
    "humidity": 65,
    "pressure": 1015,
    "visibility": 10000,
    "sunrise": "2025-03-16T06:12:34",
    "sunset": "2025-03-16T18:04:23",
    "timestamp": "2025-03-16T14:30:00"
}

2. 天気予報を取得する

特定の場所の天気予報を取得します。

{
    "location": {
        "name": "London",
        "country": "GB",
        "lat": 51.5074,
        "lon": -0.1278
    },
    "forecast": [
        {
            "datetime": "2025-03-16T15:00:00",
            "temperature": {
                "temp": 18.2,
                "feels_like": 17.8,
                "min": 17.5,
                "max": 19.1
            },
            "weather_condition": {
                "main": "Rain",
                "description": "light rain",
                "icon": "10d"
            },
            "wind": {
                "speed": 4.2,
                "deg": 180
            },
            "clouds": 75,
            "humidity": 82,
            "pressure": 1010,
            "visibility": 8000,
            "pop": 0.4
        }
        // ... more forecast items
    ],
    "days": 5
}

3. 空気の質を調べる

特定の場所の空気質データを取得します。

{
    "location": {
        "name": "Beijing",
        "country": "CN",
        "lat": 39.9042,
        "lon": 116.4074
    },
    "air_quality_index": 3,
    "air_quality_level": "Moderate",
    "components": {
        "co": 250.34,
        "no": 0.5,
        "no2": 15.2,
        "o3": 140.8,
        "so2": 5.1,
        "pm2_5": 8.2,
        "pm10": 12.3,
        "nh3": 0.7
    },
    "timestamp": "2025-03-16T14:30:00"
}

4. 過去の天気を取得する

特定の日付の過去の気象データを取得します。

{
    "location": {
        "name": "Paris",
        "country": "FR",
        "lat": 48.8566,
        "lon": 2.3522
    },
    "date": "2025-03-14",
    "temperature": {
        "temp": 20.3,
        "feels_like": 19.8
    },
    "weather_condition": {
        "main": "Clouds",
        "description": "scattered clouds",
        "icon": "03d"
    },
    "wind": {
        "speed": 2.8,
        "deg": 150
    },
    "clouds": 45,
    "humidity": 60,
    "pressure": 1012,
    "visibility": 10000,
    "sunrise": "2025-03-14T06:30:45",
    "sunset": "2025-03-14T18:15:22",
    "timestamp": "2025-03-14T12:00:00"
}

5. 検索場所

名前で場所を検索:

{
    "results": [
        {
            "name": "Tokyo",
            "state": "",
            "country": "JP",
            "lat": 35.6762,
            "lon": 139.6503
        },
        {
            "name": "Tokyo",
            "state": "Tokyo",
            "country": "JP",
            "lat": 35.6895,
            "lon": 139.6917
        }
        // ... more results
    ]
}

6. 天気予報を取得する

特定の場所の天気警報を取得します。

{
    "location": {
        "name": "Miami",
        "country": "US",
        "lat": 25.7617,
        "lon": -80.1918
    },
    "alerts": [
        {
            "sender": "NWS Miami",
            "event": "Heat Advisory",
            "start": "2025-03-16T12:00:00",
            "end": "2025-03-16T20:00:00",
            "description": "Heat index values between 105 and 110 expected",
            "tags": ["Extreme temperature value"]
        }
        // ... more alerts if any
    ],
    "alert_count": 1
}

サンプルクエリ

Claude Desktop に次のような質問をすることができます:

「ニューヨークの現在の天気はどうですか？」
「ロンドンの5日間天気予報を見せて」
「今日の北京の空気の質はどうですか？」
「3月14日のパリの天気はどうでしたか？」
「「東京」という名前の場所を検索」
「マイアミに気象警報はありますか？」
「シカゴ、マイアミ、シアトルの現在の天気を比較する」
「北京、ロサンゼルス、デリーの空気の質の比較を見せてください」

エラー処理

すべてのツールには適切なエラー処理が組み込まれており、何か問題が発生した場合にはエラーメッセージを返します。

{
    "error": "Failed to fetch current weather for InvalidLocation: Location not found"
}

トラブルシューティング

Claude Desktop で MCP サーバーが動作していない場合:

サーバーが実行中であることを確認してください。スクリプトを開始すると出力が表示されます。
設定のパスが正しく絶対パスであることを確認してください
Python 3.10+がシステムPATHにあることを確認してください
すべての依存関係がインストールされていることを確認する
Claude Desktopを再起動してみてください
ログにエラーメッセージがないか確認する

一般的なAPIの問題

APIキーの有効化: 新しいOpenWeatherMap APIキーの有効化には最大24時間かかる場合があります
無効なAPIキーエラー: 401エラーが発生した場合は、APIキーが正しくアクティブであることを確認してください。
レート制限: 無料枠では 1 分あたり最大 60 回の通話が許可されますが、使用量が多すぎると超過する可能性があります。

レート制限

このツールはOpenWeatherMap APIを使用していますが、レート制限があります。無料プランでは1分あたり最大60回の呼び出しが許可されており、個人利用には十分です。ただし、リクエスト頻度が高すぎる場合は、APIによって処理が制限される場合がありますのでご注意ください。

ライセンス

MITライセンス

Weather MCP Tool

Integrations