KnowAir Weather
About
Real-time weather **and air quality** via the Caiyun Weather API (meteorology + AQI, CN & US standards).
Details
- Author
- shuowang-ai
- Downloads
- 82
- Categories
- Other, Media
Jump to
- Real-time conditions: temperature, humidity, wind, precipitation
- Air quality: PM2.5, PM10, O₃, SO₂, NO₂, CO with CN & US AQI
- 72‑hour hourly and 7‑day daily forecasts
- Minute‑level precipitation for hyper‑local rain/snow in Chinese cities
- Astronomical data: sunrise, sunset, moon phases
- Real‑time weather warnings and advisories
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
KnowAir WeatherCommand (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
Enable the MCP with a compatible host (e.g., Claude) and then ask natural language questions about weather, air quality, forecasts, or astronomy.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"knowair weather": {
"knowair-weather": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/Weather-MCP",
"run",
"mcp-knowair-weather"
],
"env": {
"CAIYUN_WEATHER_API_TOKEN": "YOUR_API_TOKEN_HERE"
}
}
}
}
}McpServers
{
"knowair-weather": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/Weather-MCP",
"run",
"mcp-knowair-weather"
],
"env": {
"CAIYUN_WEATHER_API_TOKEN": "YOUR_API_TOKEN_HERE"
}
}
}Description
KnowAir Weather MCP is a comprehensive Model Context Protocol (MCP) server that provides real-time weather, air quality monitoring, short- and long-term forecasts, and astronomical information. Built with Python 3.12+ and FastMCP, it integrates with the Caiyun Weather API to deliver precise meteorological and environmental data.
Features
• 🌤️ Real-time conditions: temperature, humidity, wind, precipitation
• 🏙️ Air quality: PM2.5, PM10, O₃, SO₂, NO₂, CO with both CN & US AQI standards
• 📅 Forecasts: 72-hour hourly and 7-day daily predictions
• 🌧️ Minute-level precipitation: hyper-local rain/snow timing (China cities)
• 🌅 Astronomy: sunrise, sunset, moon phases
• ⚠️ Alerts: real-time weather warnings and advisories
Example Usage
Ask Claude (with this MCP enabled):
“What’s the weather in Beijing now?”
“Get comprehensive weather data for 116.4575, 39.9113”
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
