How do I install io.github.overstarry/qweather-mcp?

Install io.github.overstarry/qweather-mcp via npm from https://registry.npmjs.org, then add the server config to your MCP client (Claude Desktop, Cursor, or VS Code).

What category does io.github.overstarry/qweather-mcp belong to?

io.github.overstarry/qweather-mcp is listed under Developer Tools MCP servers on MCPFind.

io.github.overstarry/qweather-mcp — MCP Server for Developer Tools

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

🔗 Related Links

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-overstarry-qweather-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.overstarry/qweather-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.overstarry/qweather-mcp