Qweather1

qweather-mcp

English | 简体中文

QWeather API 向けの MCP サーバーです。Model Context Protocol（MCP）を通じて、包括的な気象情報の照会機能を提供します。

✨ 特長

• 🌤️ リアルタイムの天気照会
• 📅 複数日の天気予報（3／7／10／15／30日）
• 🔐 JWT（EdDSA／Ed25519）および従来の API キー認証
• 🔌 カスタム API ベース URL に対応
• 🛠️ 充実したツール連携

📦 インストール

Smithery 経由

推奨： Smithery を使って Claude Desktop に自動インストールします。

npx -y @smithery/cli install @overstarry/qweather-mcp --client claude

手動設定

1. まず、QWeather Console から認証情報を取得します。
2. サーバーを起動します。

# stdio server
npx -y qweather-mcp

3. 環境変数を設定します（以下の認証モードのいずれか1つを選択してください）。

🔐 JWT 認証（推奨）

QWeather は、API キー認証が 2027 年に廃止予定であることを発表し、JWT（EdDSA + Ed25519）への移行を推奨しています。Ed25519 キーペアを生成し、公開鍵を QWeather コンソールにアップロードして、次のように設定します。

QWEATHER_API_BASE=https://<your-host>.qweatherapi.com
QWEATHER_PROJECT_ID=<project-id>
QWEATHER_KEY_ID=<credential-id>
# Either pass the PEM path…
QWEATHER_PRIVATE_KEY_PATH=/path/to/ed25519-private.pem
# …or the PEM content directly (newlines preserved)
# QWEATHER_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"

QWEATHER_PRIVATE_KEY_PATH と QWEATHER_PRIVATE_KEY の両方が指定されている場合は、パスが優先されます。QWEATHER_PRIVATE_KEY では、2 文字の文字列 \n が実際の改行に自動変換されるため、上記のように 1 行で記述しても、シェル、.env ファイル、JSON 設定で使用できます。

JSON 設定の例：

{
  "mcpServers": {
    "qweather": {
      "command": "npx",
      "args": ["-y", "qweather-mcp"],
      "env": {
        "QWEATHER_API_BASE": "https://<your-host>.qweatherapi.com",
        "QWEATHER_PROJECT_ID": "<project-id>",
        "QWEATHER_KEY_ID": "<credential-id>",
        "QWEATHER_PRIVATE_KEY_PATH": "/path/to/ed25519-private.pem"
      }
    }
  }
}

JWT の詳細：トークンは alg=EdDSA で署名され、クロックスキューを許容するため iat は 30 秒前に設定されます。exp = iat + 900s（15 分。QWeather の 24 時間の上限を大きく下回ります）となり、有効期限の約 30 秒前までキャッシュして再利用されます。公式認証ドキュメントを参照してください。

🔑 API キー認証（従来方式）

QWEATHER_API_BASE=https://api.qweather.com
QWEATHER_API_KEY=<your-api-key>

JSON 設定の例：

{
  "mcpServers": {
    "qweather": {
      "command": "npx",
      "args": ["-y", "qweather-mcp"],
      "env": {
        "QWEATHER_API_BASE": "<your-api-url>",
        "QWEATHER_API_KEY": "<your-api-key>"
      }
    }
  }
}

モードの判定

設定されている環境変数	モード
JWT の全変数（QWEATHER_PROJECT_ID + QWEATHER_KEY_ID + QWEATHER_PRIVATE_KEY[_PATH]）	JWT（QWEATHER_API_KEY も設定されている場合でも優先）
JWT の全変数 + QWEATHER_API_KEY	JWT（API キーは無視されます）
JWT の一部の変数 + QWEATHER_API_KEY	API キー。起動時に stderr へ警告を出力します
JWT の一部の変数のみ	起動エラー
QWEATHER_API_KEY のみ	API キー
どちらもなし	起動エラー

起動時に、使用中のモードが stderr に記録されます。例：Weather MCP Server running on stdio (auth: JWT/EdDSA)。

🛠️ 利用可能なツール

get-weather-now

指定した場所の現在の天気情報を取得します。

get-weather-forecast

指定した場所の天気予報を、予報日数を選択して取得します。

• 3 日間の予報
• 7 日間の予報
• 10 日間の予報
• 15 日間の予報
• 30 日間の予報

予報データには、以下が含まれます。

• 気温の範囲（最低／最高）
• 昼夜の天気
• 日の出／日の入り時刻
• 降水量
• 湿度
• 風の状況
• UV 指数

get-minutely-precipitation

今後 2 時間の分単位の降水予報を提供します。以下が含まれます。

• 降水の種類（雨／雪）
• 1 分ごとの降水量
• 正確な時刻予測
• リアルタイムの予報説明

get-hourly-forecast

24 時間、72 時間、または 168 時間の時間ごとの天気予報を提供します。以下が含まれます。

• 気温の変化
• 天気
• 風向と風力
• 相対湿度
• 気圧
• 降水確率
• 雲量

get-weather-warning

次の情報を含む、リアルタイムの気象警報情報を提供します。

• 警報発表機関
• 警報レベルと種類
• 警報の詳細内容
• 警報の有効期間
• 関連する推奨事項

get-weather-indices

さまざまな種類の指数に対応した、天気に関する生活指数情報を提供します。

• スポーツ指数
• 洗車指数
• 服装指数
• 釣り指数
• 紫外線指数
• 観光指数
• アレルギー指数 および、その他16種類の生活指数

get-air-quality

次の情報を含む、リアルタイムの大気質データを提供します。

• AQI 指数
• 大気質レベル
• 主要汚染物質
• 健康に関するアドバイス
• 汚染物質濃度

get-air-quality-hourly

次の24時間の1時間ごとの大気質予報を提供します。

• 1時間ごとの AQI 予測
• 汚染物質濃度の変化
• 健康への影響評価
• 保護に関する推奨事項

get-air-quality-daily

次の3日間の大気質予報を提供します。

• 日ごとの AQI 予測
• 主要汚染物質の予測
• 大気質レベルの変化
• 健康を守るためのアドバイス

🤝 貢献

問題の報告や改善の提案を歓迎します！貢献ガイドラインをご確認ください。

📄 ライセンス

MIT

🔗 関連リンク

• QWeather 公式ウェブサイト
• API ドキュメント
• コンソール