Caiyun Weather MCP Server

Caiyun Weather MCP サーバー

ホスト型サーバー

Caiyun Weather では、ホスト型の Streamable HTTP MCP サーバーを提供しているため、このパッケージをローカルにインストールしたり実行したりせずに、天気ツールを利用できます。

{
  "url": "https://mcp-weather.caiyunapp.com/mcp",
  "headers": {
    "X-Caiyun-API-Key": "YOUR_CAIYUN_WEATHER_API_KEY"
  }
}

外側の設定形式は、使用する MCP クライアントによって異なります。利用を開始する前に、Caiyun Weather API キーを登録して申請し、X-Caiyun-API-Key リクエストヘッダーで渡してください。

セットアップ手順

まず 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：指定した時間数の時間ごとの天気予報を取得します

  • パラメーター：
    • lng：場所の経度
    • lat：場所の緯度
    • hours：返す時間数（1～360、既定値は72）
  • 次のような時間ごとの予報を返します：
    • 気温
    • 天気の状況
    • 降雨確率
    • 降水強度（mm/hr）
    • 風速と風向

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

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

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

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

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

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

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