Caiyun Weather MCP Server

Name: Caiyun Weather MCP Server
Author: caiyunapp

@caiyunapp

Repository

About Caiyun Weather MCP Server

An Official Model Context Protocol (MCP) server for Caiyun Weather. 彩云天气官方 MCP Server

#caiyun #weather #api #colorfulclouds

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uvx",
      "args": [
        "mcp-caiyun-weather"
      ],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Tools

Get the realtime weather for a location.

Get hourly weather forecast for the next 72 hours.

Get daily weather forecast for the next 7 days.

Get historical weather data for the past 24 hours.

Get weather alerts for the location.

Overview

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.