io.github.overstarry/qweather-mcp
a qweather mcp server
Ask AI about io.github.overstarry/qweather-mcp
Powered by Claude ยท Grounded in docs
I know everything about io.github.overstarry/qweather-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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