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:

Manual Configuration

1. First, get your API Key from the QWeather Console.

2. Start the server:

3. Configure environment variables:

JSON Configuration

Add to your configuration file:

🛠️ 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

🔗 Related Links

• QWeather Official Website

• API Documentation

• Console