Python
MIT License
The qweather-mcp server provides comprehensive weather data query capabilities via the QWeather API using Model Context Protocol (MCP). With this server, you can:
- Look up city information by name
- Get current weather conditions
- Retrieve multi-day weather forecasts (3, 7, 10, 15, or 30 days)
- Obtain minute-by-minute precipitation forecasts for the next 2 hours
- Access hourly weather forecasts for up to 168 hours
- Check for real-time weather warning information
- Query various weather-related life indices (e.g., sports, car wash, dressing)
- Fetch real-time air quality data
- Get hourly and daily air quality forecasts
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
- First, get your API Key from the QWeather Console.
- Start the server:
- 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
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
qweather mcp
Related MCP Servers
- Python
- Python
- JavaScript