Access Real-Time Weather and Forecast Data

KnowAir Weather MCP Server provides real-time weather, air quality monitoring, forecasts, and astronomical data powered by the Caiyun Weather API. It covers realtime conditions (temperature, feels-like, humidity, wind, visibility, air quality), hourly forecasts up to 360 hours, daily forecasts up to 15 days, minute-level precipitation forecasts for the next 2 hours, historical weather for the past 72 hours, active weather alerts, and astronomical data (sunrise/sunset, moon phases). A newer combined tool provides realtime, forecast, alert, and astronomy data in one call. It also includes a dedicated air-quality-station-enhanced forecast that blends 5 days of high-precision monitoring station data with 6-15 day API forecasts, including AQI/PM2.5/PM10/O3 trend analysis and health recommendations.

Weather phenomena and life indices (UV index, clothing index, comfort index, cold/flu risk, car-wash suitability) are fully localized into Chinese with emoji-based formatting for readability.

Use this connector when you want an assistant to answer weather and air-quality questions - current conditions, multi-day forecasts, precipitation timing, or health-relevant air quality trends - for a given longitude/latitude, with rich Chinese-localized output.

Do not use it without a valid Caiyun Weather API token, and note it primarily targets Chinese cities for minute-level precipitation forecasting; coverage and precision may be strongest there compared to other regions.

Most tools take lng (longitude) and lat (latitude), plus a time range parameter specific to the tool (hours, days, hours_back). Outputs are structured weather/air-quality data - temperature, humidity, wind, AQI/PM2.5/PM10/O3/NO2/SO2/CO readings, precipitation intensity, alerts, or astronomical timing - formatted with Chinese labels and emoji indicators.

• get_realtime_weather: current temperature, feels-like, humidity, wind, air quality, and life indices
• get_hourly_forecast: hourly forecast for 1-360 hours with air quality and trend analysis
• get_daily_forecast: daily forecast for 1-15 days with temperature range, precipitation probability, and life indices
• get_air_quality_station_forecast: 15-day air quality forecast blending monitoring-station and API data with trend analysis and health advice
• get_minutely_precipitation: minute-level precipitation intensity for the next 2 hours
• get_comprehensive_weather: one-stop combined realtime + forecast + alerts + astronomy report
• get_weather_alerts: currently active weather alerts
• get_astronomy_info: sunrise/sunset and moon phase data for 1-15 days
• get_historical_weather: historical weather for the past 1-72 hours

Requires a Caiyun Weather API token (docs.caiyunapp.com/weather-api) and uv:

{
  "mcpServers": {
    "knowair-weather": {
      "command": "uvx",
      "args": ["mcp-knowair-weather"],
      "env": { "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE" }
    }
  }
}

Requires Python 3.12+.

Users who want detailed, Chinese-localized weather and air quality data - including health-relevant AQI trend analysis - in an AI assistant.