qweather-mcp

English | 简体中文

MCP server for QWeather API, providing comprehensive weather information query capabilities through Model Context Protocol (MCP).

✨ Features

🌤️ Real-time weather queries
📅 Multi-day weather forecasts (3/7/10/15/30 days)
🔑 Simple API key configuration
🔌 Custom API base URL support
🛠️ Complete tool integration

📦 Installation

Via Smithery

Recommended: Install automatically for Claude Desktop using Smithery:

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

Manual Configuration

First, get your API Key from the QWeather Console.
Start the server:

# stdio server
npx -y qweather-mcp

Configure environment variables:

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

JSON Configuration

Add to your configuration file:

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

🛠️ Available Tools

get-weather-now

Get current weather information for a specified location.

get-weather-forecast

Get weather forecast information for a specified location with customizable forecast days:

3-day forecast
7-day forecast
10-day forecast
15-day forecast
30-day forecast

Forecast data includes:

Temperature range (min/max)
Day/night weather conditions
Sunrise/sunset times
Precipitation
Humidity
Wind conditions
UV index

get-minutely-precipitation

Provides minute-by-minute precipitation forecast for the next 2 hours, including:

Precipitation type (rain/snow)
Precipitation amount per minute
Precise time predictions
Real-time forecast descriptions

get-hourly-forecast

Provides hourly weather forecasts for 24, 72, or 168 hours, including:

Temperature changes
Weather conditions
Wind direction and force
Relative humidity
Atmospheric pressure
Precipitation probability
Cloud coverage

get-weather-warning

Provides real-time weather warning information, including:

Warning issuing authority
Warning level and type
Detailed warning content
Warning validity period
Related recommendations

get-weather-indices

Provides weather life indices information, supporting various index types:

Sports index
Car wash index
Dressing index
Fishing index
UV index
Tourism index
Allergy index and 16 other life indices

get-air-quality

Provides real-time air quality data, including:

AQI index
Air quality level
Primary pollutants
Health advice
Pollutant concentrations

get-air-quality-hourly

Provides hourly air quality forecast for the next 24 hours:

Hourly AQI predictions
Pollutant concentration changes
Health impact assessment
Protection recommendations

get-air-quality-daily

Provides air quality forecast for the next 3 days:

Daily AQI predictions
Primary pollutant forecasts
Air quality level changes
Health protection advice

🤝 Contributing

Issues and improvements are welcome! Please check our contribution guidelines.

📄 License

MIT