Overview
What is Weather?
Weather is an MCP server that wraps the Caiyun Weather API, enabling AI assistants to retrieve real-time weather, forecasts, historical data, and weather alerts for any location. It is designed for users of Claude Desktop or any MCP client who need on-demand weather information.
How to use Weather?
Install uv, then configure the server in claude_desktop_config.json using the command uvx mcp-caiyun-weather and set the CAIYUN_WEATHER_API_TOKEN environment variable. After setup, ask a question like “What’s the weather in Beijing Now?” to invoke the tools.
Key features of Weather
- Real-time weather data for a specific location.
- Hourly forecast for the next 72 hours.
- Daily forecast for the next 7 days.
- Historical weather for the past 24 hours.
- Weather alerts with title, code, status, description.
- Air quality metrics (PM2.5, PM10, AQI, etc.).
Use cases of Weather
- Ask your AI assistant for current weather conditions.
- Plan outdoor activities using hourly or weekly forecasts.
- Check air quality indices before traveling.
- Monitor severe weather alerts for a location.
- Analyze recent historical weather trends.
FAQ from Weather
How do I get an API token?
Apply for a token at https://docs.caiyunapp.com/weather-api/.
What tools does Weather provide?
Five tools: get_realtime_weather, get_hourly_forecast, get_weekly_forecast, get_historical_weather, and get_weather_alerts.
Where do I configure the server?
In the claude_desktop_config.json file under the mcpServers section, accessible via Claude Desktop’s Developer settings.
What parameters do all tools require?
All tools require lng (longitude) and lat (latitude) of the target location.
