Qweather Mcp
Connects Claude to QWeather's comprehensive weather API with support for real-time conditions, multi-day forecasts (3/7/10/15/30 days), minute-by-minute precipitation tracking, hourly predictions, weather warnings, air quality data, and lifestyle indices like UV, sports, and allergy ratings. Supports both JWT (EdDSA/Ed25519) authentication and legacy API keys, with JWT recommended since QWeather is deprecating API keys in 2027. The server auto-caches JWT tokens until near expiry and handles clock skew gracefully. Useful when you need precise Chinese weather data or want to build weather-aware applications that can query conditions, issue warnings, or advise users based on comprehensive meteorological indices beyond basic temperature and precipitation.
- GitHub stars
- 7
- tools
- 9
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Sep 10, 2025
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
get-weather-nowGet current weather information for a specified location.
Get current weather information for a specified location.
No parameter schema in public metadata yet.
get-weather-forecastGet weather forecast information for a specified location with customizable forecast days.
Get weather forecast information for a specified location with customizable forecast days.
No parameter schema in public metadata yet.
get-minutely-precipitationProvides minute-by-minute precipitation forecast for the next 2 hours, including precipitation type, amount per minute, precise time predictions and real-time forecast descriptions.
Provides minute-by-minute precipitation forecast for the next 2 hours, including precipitation type, amount per minute, precise time predictions and real-time forecast descriptions.
No parameter schema in public metadata yet.
get-hourly-forecastProvides hourly weather forecasts for 24, 72, or 168 hours, including temperature changes, weather conditions, wind, humidity, pressure, precipitation probability and cloud coverage.
Provides hourly weather forecasts for 24, 72, or 168 hours, including temperature changes, weather conditions, wind, humidity, pressure, precipitation probability and cloud coverage.
No parameter schema in public metadata yet.
get-weather-warningProvides real-time weather warning information, including issuing authority, warning level and type, detailed content, validity period and related recommendations.
Provides real-time weather warning information, including issuing authority, warning level and type, detailed content, validity period and related recommendations.
No parameter schema in public metadata yet.
get-weather-indicesProvides weather life indices information, supporting various index types such as sports, car wash, dressing, fishing, UV, tourism and allergy indices, and 16 other life indices.
Provides weather life indices information, supporting various index types such as sports, car wash, dressing, fishing, UV, tourism and allergy indices, and 16 other life indices.
No parameter schema in public metadata yet.
get-air-qualityProvides real-time air quality data, including AQI index, air quality level, primary pollutants, health advice and pollutant concentrations.
Provides real-time air quality data, including AQI index, air quality level, primary pollutants, health advice and pollutant concentrations.
No parameter schema in public metadata yet.
get-air-quality-hourlyProvides hourly air quality forecast for the next 24 hours, including hourly AQI predictions, pollutant concentration changes, health impact assessment and protection recommendations.
Provides hourly air quality forecast for the next 24 hours, including hourly AQI predictions, pollutant concentration changes, health impact assessment and protection recommendations.
No parameter schema in public metadata yet.
get-air-quality-dailyProvides air quality forecast for the next 3 days, including daily AQI predictions, primary pollutant forecasts, air quality level changes and health protection advice.
Provides air quality forecast for the next 3 days, including daily AQI predictions, primary pollutant forecasts, air quality level changes and health protection advice.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
QWEATHER_API_BASE*secretYour qweather api host
QWEATHER_API_KEY*secretYour qweather api key
Readme
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)
- 🔐 JWT (EdDSA/Ed25519) and legacy API Key authentication
- 🔌 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
Details
- Repository
- github.com/overstarry/qweather-mcp
- Package
qweather-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active