Qweather Mcp Server Unofficial

非公式 QWeather MCP

QWeather API 用の非公式 MCP（Multiagent Conversation Protocol）ラッパーです。このパッケージでは、MCP を通じて QWeather の包括的な気象データサービスに簡単にアクセスでき、AI エージェント、チャットボット、その他のアプリケーションとの連携が可能です。

機能

• 都市検索：都市名、座標、LocationID、または Adcode で都市を検索します
• POI 検索：景勝地や駅などの地点を検索します
• リアルタイムの天気：世界各地の現在の気象状況を取得します
• 天気予報：3～30 日間の日別予報と、最大 7 日間の時間別予報を取得します
• 気象警報：地域ごとのリアルタイム災害警報と警報一覧にアクセスします
• 気象指数：紫外線指数やスポーツ指数などの生活関連指数を取得します
• 大気質：詳細な汚染物質情報を含む、リアルタイムおよび予測大気質データを取得します

インストール

pip install unoff-qweather-mcp

認証

このパッケージを使用するには QWeather API キーが必要です。次の手順を行ってください。

1. QWeather Developer Platform でアカウントを登録します
2. 開発者コンソールで API キーを作成します
3. 次の環境変数を設定します。

export QWEATHER_API_KEY="your_api_key_here"
export QWEATHER_API_HOST="api.qweather.com"  # or another appropriate host based on your subscription

API ホストはサブスクリプションのプランによって異なります。詳しくはQWeather API Configurationをご覧ください。

使用方法

Claude MCP として実行する

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

# Clone and config the env
git clone https://github.com/HongpengM/unoff-qweather-mcp.git

# Set up your environment variables by copying the example file
copy env.example .env

# Run the MCP server
uv --directory /path/to/your_dir run src/unoff_qweather/qweather.py

公開済みのバージョンを使用する場合：

{
  "mcpServers": {
    "qweather": {
      "command": "uvx",
      "args": [
        "unoff-qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_KEY": "your_api_key_here",
        "QWEATHER_API_HOST": "api.qweather.com" 
      }
    }
  }
}

ローカルに取得したリポジトリを使用する場合：

{
  "mcpServers": {
    "qweather": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your_dir",
        "run",
        "src/unoff_qweather/qweather.py"
      ],
      "env": {
        "QWEATHER_API_KEY": "your_api_key_here",
        "QWEATHER_API_HOST": "api.qweather.com" 
      }
    }
  }
}

利用可能なツール

このパッケージでは、次の MCP ツールを利用できます。

• lookup_city - 都市名または座標で都市を検索します
• lookup_poi - 地点を検索します
• weather_now - 現在の気象状況を取得します
• weather_forecast_days - 日別の天気予報を取得します（3～30 日間）
• weather_forecast_hours - 時間別の天気予報を取得します（24～168 時間）
• warning_city_list - 気象警報が発令中の都市を取得します
• weather_warning - 指定した場所の詳細な気象警報を取得します
• weather_indices - 生活関連指数（紫外線、スポーツなど）を取得します
• air_quality_now - 現在の大気質データを取得します
• air_quality_forecast - 大気質予報を取得します

パラメーターの詳細については、コード内の各関数の docstring をご覧ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳しくはLICENSEファイルをご覧ください。

免責事項

これは非公式のラッパーであり、QWeather との提携関係はなく、QWeather による推奨も受けていません。このパッケージを使用する際は、QWeather の利用規約を遵守する必要があります。