qweather-mcp

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
• 🔄 MCP 2026-07-28 support with legacy client compatibility

📦 Installation

Node.js 20 or later is required.

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

🔗 Related Links

• QWeather Official Website
• API Documentation
• Console