Qweather Mcp Server Unofficial
Description
# Unofficial QWeather MCP An unofficial MCP (Multiagent Conversation Protocol) wrapper for the QWeather API. This package provides tools to easily access QWeather's comprehensive weather data services through MCP, allowing integration with AI agents, chatbots, and other…
About
# Unofficial QWeather MCP An unofficial MCP (Multiagent Conversation Protocol) wrapper for the QWeather API. This package provides tools to easily access QWeather's comprehensive weather data services through MCP, allowing integration with AI agents, chatbots, and other applications. ## Features - **City Lookup**…
Details
- Author
- HongpengM
- Downloads
- 270
- Categories
- Other
Jump to
- City lookup by name, coordinates, LocationID, or Adcode
- POI lookup for scenic spots and stations
- Real-time current weather conditions for global locations
- Daily weather forecasts for 3–30 days
- Hourly weather forecasts up to 7 days
- Real-time disaster warnings and warning lists by region
- Lifestyle indices (UV, sports conditions, etc.)
- Real-time and forecast air quality data with pollutant details
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Qweather Mcp Server UnofficialCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via pip install unoff-qweather-mcp. Set the environment variables QWEATHER_API_KEY and QWEATHER_API_HOST. To use with Claude Desktop, configure the MCP server in claude_desktop_config.json using the uv command pointing to the server script. The server can also be used programmatically as a Python library.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"qweather mcp server unofficial": {
"qweather": {
"command": "uv",
"args": [
"--directory",
"/path/to/your_dir",
"run",
"src/unoff_qweather/qweather.py"
],
"env": {
"QWEATHER_API_KEY": "your_api_key_here",
"QWEATHER_API_HOST": "api.qweather.com"
}
}
}
}
}McpServers
{
"qweather": {
"command": "uv",
"args": [
"--directory",
"/path/to/your_dir",
"run",
"src/unoff_qweather/qweather.py"
],
"env": {
"QWEATHER_API_KEY": "your_api_key_here",
"QWEATHER_API_HOST": "api.qweather.com"
}
}
}Unofficial QWeather MCP
An unofficial MCP (Multiagent Conversation Protocol) wrapper for the QWeather API. This package provides tools to easily access QWeather's comprehensive weather data services through MCP, allowing integration with AI agents, chatbots, and other applications.
Features
- City Lookup: Search for cities by name, coordinates, LocationID or Adcode
- POI Lookup: Find points of interest like scenic spots and stations
- Real-time Weather: Get current weather conditions for global locations
- Weather Forecasts: Daily forecasts for 3-30 days and hourly forecasts up to 7 days
- Weather Warnings: Access real-time disaster warnings and warning lists by region
- Weather Indices: Get lifestyle indices like UV index, sports conditions, etc.
- Air Quality: Real-time and forecast air quality data with detailed pollutant information
Installation
pip install unoff-qweather-mcp
Authentication
This package requires a QWeather API key. You'll need to:
1. Register for an account at QWeather Developer Platform
2. Create an API key in the developer console
3. Set the following environment variables:
export QWEATHER_API_KEY="your_api_key_here"
export QWEATHER_API_HOST="api.qweather.com" # or another appropriate host based on your subscription
The API host depends on your subscription tier. See QWeather API Configuration for details.
Usage
Running as an Claude MCP
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
# Clone and config the env
git clone https://github.com/HongpengM/unoff-qweather-mcp.git
Set up your environment variables by copying the example file
copy env.example .env
Run the MCP server
uv --directory /path/to/your_dir run src/unoff_qweather/qweather.py
{
"mcpServers": {
"qweather": {
"command": "uv",
"args": [
"--directory",
"/path/to/your_dir",
"run",
"src/unoff_qweather/qweather.py"
],
"env": {
"QWEATHER_API_KEY": "your_api_key_here",
"QWEATHER_API_HOST": "api.qweather.com"
}
}
}
}
Example: Get current weather for a location
# First lookup a city to get its LocationID
cities = await client.lookup_city(location="London")
location_id = cities["location"][0]["id"]
Get current weather conditions
weather = await client.weather_now(location=location_id)
print(f"Temperature: {weather['now']['temp']}°C")
print(f"Weather: {weather['now']['text']}")
Example: Get a 7-day forecast
forecast = await client.weather_forecast_days(location=location_id, days=7)
for day in forecast["daily"]:
print(f"Date: {day['fxDate']}, Max: {day['tempMax']}°C, Min: {day['tempMin']}°C, Weather: {day['textDay']}")
Available Tools
This package provides the following MCP tools:
- lookup_city - Search for cities by name or coordinates
- lookup_poi - Find points of interest
- weather_now - Get current weather conditions
- weather_forecast_days - Get daily weather forecasts (3-30 days)
- weather_forecast_hours - Get hourly weather forecasts (24-168 hours)
- warning_city_list - Get cities with active weather warnings
- weather_warning - Get detailed weather warnings for a location
- weather_indices - Get lifestyle indices (UV, sports, etc.)
- air_quality_now - Get current air quality data
- air_quality_forecast - Get air quality forecasts
For detailed parameter information, see each function's docstring in the code.
Running with MCP.so
This package can be deployed on MCP.so to create a publicly accessible API. To deploy:
1. Make sure you have an MCP.so account
2. Install the MCP CLI: pip install mcp[cli]
3. Log in to MCP.so: mcp login
4. Deploy your MCP: mcp deploy
License
This project is licensed under the MIT License - see the LICENSE file for details.
Disclaimer
This is an unofficial wrapper and not affiliated with or endorsed by QWeather. Users must comply with QWeather's terms of service when using this package.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
