Weather

Caiyun Weather MCP Server

セットアップ手順

まず、API を利用できることを確認してください。API は https://docs.caiyunapp.com/weather-api/ から申請できます。

最初に uv をインストールしてください。

MacOS/Linux：

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

Windows：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Claude Desktop でのセットアップ

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uvx",
      "args": ["mcp-caiyun-weather"],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

天気情報が必要な質問を Claude にする

例：「今の北京の天気は？」

ローカル／開発環境でのセットアップ手順

Claude Desktop でのセットアップ

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather",
        "run",
        "mcp-caiyun-weather"
      ],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

デバッグ

次を実行します：

npx @modelcontextprotocol/inspector \
      uv \
      --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather \
      run \
      mcp-caiyun-weather

利用可能なツール

• get_realtime_weather：特定の場所のリアルタイムの気象データを取得します

  • パラメーター：
    • lng：場所の経度
    • lat：場所の緯度
  • 次のような詳細情報を返します：
    • 気温
    • 湿度
    • 風速と風向
    • 降水強度
    • 大気質指標（PM2.5、PM10、O3、SO2、NO2、CO）
    • AQI（中国および米国の基準）
    • 生活指数（紫外線指数と快適度）

• get_hourly_forecast：今後72時間の1時間ごとの天気予報を取得します

  • パラメーター：
    • lng：場所の経度
    • lat：場所の緯度
  • 次のような1時間ごとの予報を返します：
    • 気温
    • 気象状況
    • 降雨確率
    • 風速と風向

• get_weekly_forecast：今後7日間の日ごとの天気予報を取得します

  • パラメーター：
    • lng：場所の経度
    • lat：場所の緯度
  • 次のような日ごとの予報を返します：
    • 気温の範囲（最低／最高）
    • 気象状況
    • 降雨確率

• get_historical_weather：過去24時間の気象データを取得します

  • パラメーター：
    • lng：場所の経度
    • lat：場所の緯度
  • 次のような過去のデータを返します：
    • 気温
    • 気象状況

• get_weather_alerts：特定の場所の気象警報を取得します

  • パラメーター：
    • lng：場所の経度
    • lat：場所の緯度
  • 次のような気象警報を返します：
    • 警報のタイトル
    • 警報コード
    • 警報ステータス
    • 警報の説明

注：すべてのツールを使用するには、有効な Caiyun Weather API トークンを環境変数 CAIYUN_WEATHER_API_TOKEN に設定する必要があります。