Qweather1

Name: Qweather1
Author: overstarry

@overstarry

Repository Homepage

About Qweather1

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "qweather1": {
      "command": "npx",
      "args": [
        "-y",
        "qweather-mcp"
      ],
      "env": {
        "QWEATHER_API_BASE": "<your-api-base-url>",
        "QWEATHER_API_KEY": "<your-api-key>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Qweather1?

Qweather1 is an MCP (Model Context Protocol) server that wraps the QWeather API. It enables AI assistants to query comprehensive weather information including real-time conditions, forecasts, precipitation, air quality, and life indices. The server is intended for developers building weather‑aware applications with LLM agents.

How to use Qweather1?

Install and configure the server manually via npx -y qweather-mcp or automatically via Smithery for Claude Desktop. Set environment variables for authentication (JWT using EdDSA/Ed25519 keys or a legacy API key) and optionally a custom API base URL. The server runs on stdio and provides tools that can be called by the AI client.

Key features of Qweather1

Real‑time weather queries and multi‑day forecasts (3/7/10/15/30 days)
JWT (EdDSA/Ed25519) and legacy API key authentication
Custom API base URL support
Complete tool integration for weather, air quality, and life indices
Minute‑by‑minute precipitation forecast for the next 2 hours
Hourly forecasts for 24, 72, or 168 hours

Use cases of Qweather1

Integrate current weather and daily forecasts into personal assistant chatbots
Provide air quality alerts and health recommendations to users
Enable trip planning with long‑range forecasts and life indices (dressing, UV, etc.)
Automate weather‑dependent decision‑making in smart home or agricultural systems
Combine weather warnings with other data sources for safety applications

FAQ from Qweather1

What authentication methods does Qweather1 support?

The server supports both JWT authentication (EdDSA Ed25519, recommended) and legacy API key authentication. JWT is preferred as QWeather plans to deprecate API key auth in 2027.

How do I install Qweather1?

You can install it via Smithery (npx -y @smithery/cli install @overstarry/qweather-mcp --client claude) or manually by running npx -y qweather-mcp and configuring environment variables.

What weather data can I get from Qweather1?

The server provides current weather, 3–30‑day forecasts, hourly forecasts (24/72/168h), 2‑hour minutely precipitation, weather warnings, 18 life indices, and real‑time, hourly, and daily air quality data.

Where do I get the credentials to use Qweather1?

Obtain your credentials from the QWeather Console at https://console.qweather.com/. For JWT you need a project ID, key ID, and an Ed25519 private key; for legacy auth you need an API key.

Is the API key method still supported?

Yes, it is currently supported but QWeather has announced its deprecation in 2027. The server will use JWT mode if all JWT environment variables are present, even if an API key is also set.