caiyunapp/mcp-caiyun-weather

## Hosted Server
Caiyun Weather provides a hosted Streamable HTTP MCP server, so you can use
the weather tools without installing or running this package locally.
json
"url": "https://mcp-weather.caiyunapp.com/mcp",
"headers": {
"X-Caiyun-API-Key": "YOURCAIYUNWEATHERAPIKEY"
The outer configuration format depends on your MCP client. Before getting
started, register and apply for a Caiyun Weather API key,
then pass it in the X-Caiyun-API-Key request header.
## Setup Instructions
Install uv first.
MacOS/Linux:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
### Setup with Claude Desktop
# claudedesktopconfig.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
"mcpServers": {
"caiyun-weather": {
"command": "uvx",
"args": ["mcp-caiyun-weather"],
"env": {
"CAIYUNWEATHERAPITOKEN": "YOURAPIKEYHERE"
### Ask Claude a question requiring weather
e.g. "What's the weather in Beijing Now?"
## Local/Dev Setup Instructions
### Setup with Claude Desktop
# claudedesktopconfig.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
"mcpServers": {
"caiyun-weather": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather",
"run",
"mcp-caiyun-weather"
],
"env": {
"CAIYUNWEATHERAPITOKEN": "YOURAPITOKENHERE"
### Debugging
Run:
bash
npx @modelcontextprotocol/inspector \
uv \
--directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather \
run \
mcp-caiyun-weather
## Available Tools
getrealtimeweather: Get real-time weather data for a specific location
Parameters:
lng: The longitude of the location
lat: The latitude of the location
Returns detailed information including:
Temperature and apparent temperature
Sky condition
Humidity
Wind speed and direction
Precipitation intensity
Air quality metrics (PM2.5, PM10, O3, SO2, NO2, CO)
AQI (China and USA standards)
Life indices (UV and Comfort)
gethourlyforecast: Get an hourly weather forecast for a configurable number of hours
Parameters:
lng: The longitude of the location
lat: The latitude of the location
hours: The number of hours to return (1–360, defaults to 72)
Returns hourly forecast including:
Temperature
Weather conditions
Rain probability
Precipitation intensity (mm/hr)
Wind speed and direction
getweeklyforecast: Get daily weather forecast for the next 7 days
Parameters:
lng: The longitude of the location
lat: The latitude of the location