Caiyun Weather MCP Server

What is Caiyun Weather MCP Server?

A Model Context Protocol server that provides weather data from the Caiyun Weather API. It offers tools for real-time observations, hourly forecasts (72 hours), weekly forecasts (7 days), historical data (past 24 hours), and weather alerts. Designed for use with MCP clients like Claude Desktop.

How to use Caiyun Weather MCP Server?

Install the uv package manager, then configure Claude Desktop by adding an entry to claude_desktop_config.json with the command uvx, args ["mcp-caiyun-weather"], and the environment variable CAIYUN_WEATHER_API_TOKEN set to a valid API token. Once configured, ask Claude a question such as "What's the weather in Beijing Now?".

Key features of Caiyun Weather MCP Server

• get_realtime_weather: current temperature, humidity, wind, precipitation, and air quality
• get_hourly_forecast: hourly temperature, conditions, rain probability, and wind for 72 hours
• get_weekly_forecast: daily temperature range, conditions, and rain probability for 7 days
• get_historical_weather: past 24 hours of temperature and weather conditions
• get_weather_alerts: location-specific alert titles, codes, statuses, and descriptions

Use cases of Caiyun Weather MCP Server

• Check current weather conditions and air quality for any location
• Plan outdoor activities using hourly rain probability and wind forecasts
• Review yesterday's weather to compare with current conditions
• Receive proactive weather alerts for a given latitude/longitude

FAQ from Caiyun Weather MCP Server

What API token is required?

A valid Caiyun Weather API token must be set in the CAIYUN_WEATHER_API_TOKEN environment variable. Apply for one at the Caiyun Weather API docs page.

How do I install and configure the server?

First install uv (curl for macOS/Linux, PowerShell for Windows). Then add the server configuration to Claude Desktop's claude_desktop_config.json using uvx and your API token.

What tools does the server expose?

Five tools: get_realtime_weather, get_hourly_forecast, get_weekly_forecast, get_historical_weather, and get_weather_alerts.

What are the runtime dependencies?

The uv package manager is required. For production use, the uvx command handles the server automatically. For local development, point uv to a local directory.

How can I debug the server?

Run npx @modelcontextprotocol/inspector with the uv command and the local directory path to inspect tool calls and responses.