What is Mcp Caiyun Weather

mcp-caiyun-weather is a MCP Server that provides real-time weather data using the Caiyun Weather API. It allows users to retrieve detailed weather information for specific locations.

Use cases

Use cases for mcp-caiyun-weather include developing weather forecasting applications, integrating weather data into travel apps, providing real-time weather updates for event planning, and enhancing smart home systems with weather information.

How to use

To use mcp-caiyun-weather, first ensure you have access to the Caiyun Weather API by applying for an API key. Then, install the necessary tools and configure the server in the Claude Desktop settings with your API key. You can ask weather-related questions to Claude, such as ‘What’s the weather in Beijing now?’

Key features

Key features of mcp-caiyun-weather include real-time weather data retrieval, detailed weather metrics such as temperature, humidity, wind speed, precipitation intensity, and air quality metrics (PM2.5, PM10, O3, SO2, NO2, CO). It also provides AQI based on both China and USA standards.

Where to use

mcp-caiyun-weather can be used in various fields such as mobile applications, web applications, and any software requiring weather data integration for enhanced user experience.

Caiyun Weather MCP Server

Setup Instructions

Before anything, ensure you have access to the API. You can apply for it at https://docs.caiyunapp.com/weather-api/.

Install uv first.

MacOS/Linux:

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

Windows:

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

Setup with 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"
      }
    }
  }
}

Ask Claude a question requiring weather

e.g. “What’s the weather in Beijing Now?”

Local/Dev Setup Instructions

Setup with 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"
      }
    }
  }
}

Debugging

Run:

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

Available Tools

• get_realtime_weather: Get real-time weather data for a specific location

  • Parameters:
    • lng: The longitude of the location
    • lat: The latitude of the location
  • Returns detailed information including:
    • Temperature
    • Humidity
    • Wind speed and direction
    • Precipitation intensity
    • Air quality metrics (PM2.5, PM10, O3, SO2, NO2, CO)
    • AQI (China and USA standards)
    • Life indices (UV and Comfort)

• get_hourly_forecast: Get hourly weather forecast for the next 72 hours

  • Parameters:
    • lng: The longitude of the location
    • lat: The latitude of the location
  • Returns hourly forecast including:
    • Temperature
    • Weather conditions
    • Rain probability
    • Wind speed and direction

• get_weekly_forecast: Get daily weather forecast for the next 7 days

  • Parameters:
    • lng: The longitude of the location
    • lat: The latitude of the location
  • Returns daily forecast including:
    • Temperature range (min/max)
    • Weather conditions
    • Rain probability

• get_historical_weather: Get historical weather data for the past 24 hours

  • Parameters:
    • lng: The longitude of the location
    • lat: The latitude of the location
  • Returns historical data including:
    • Temperature
    • Weather conditions

• get_weather_alerts: Get weather alerts for a specific location

  • Parameters:
    • lng: The longitude of the location
    • lat: The latitude of the location
  • Returns weather alerts including:
    • Alert title
    • Alert code
    • Alert status
    • Alert description

Note: All tools require a valid Caiyun Weather API token to be set in the environment variable CAIYUN_WEATHER_API_TOKEN.