Advertise
MCP.so
Sign In

Caiyun Weather MCP Server

@caiyunapp

Repository

Basic information

Category

Media & Design

Transports

stdio

Author

caiyunapp

Submitted by

liluo

About Caiyun Weather MCP Server

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

#caiyun#weather#api#colorfulclouds

Caiyun Weather MCP Server 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"
      }
    }
  }
}

Caiyun Weather MCP Server tools

5

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

Frequently asked questions

1

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.

2

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.

3

What tools does the server expose?

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

4

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.

5

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.

Comments

More Media & Design MCP servers

Whiteboard Animation

WhiteboardAnimation.ai

Turn any picture into a hand-drawn whiteboard animation video from Claude, ChatGPT, Cursor or any MCP client. Remote server, OAuth sign-in, no API key.

Green Screen Memes

Green Screen Memes

Green Screen Memes is a remote MCP server available at https://api.greenscreenmemes.app.

Blaze

Blaze

Plan, create and schedule social media content from your AI assistant. Blaze makes on-brand posts, carousels and short videos, writes blog posts and newsletters, and schedules them to Instagram, TikTok, YouTube, LinkedIn

Vid Kraken

Vid Kraken

YouTube download API and MCP server. Download YouTube videos as MP4 (360p–4K) or audio as MP3/AAC, cut clips by start and end time, and get video metadata. No yt-dlp, proxies or cookies to maintain; 99.99% of downloads s

Cardboard AI

A video editor you use by chatting in Claude or ChatGPT. Bring your footage, ask for cuts, captions, titles and music, then download the finished video.

Advertise