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

InstantClips

InstantStudioAI

InstantClips turns an e-commerce product into short-form vertical video for TikTok, Instagram Reels and Stories. Import a product from its page URL or photos, generate on-brand video ads, and manage brands/products throu

A

AdvisorIQ

Continuing education rules for US financial advisors (CFP, CFA, IWI, IAR by state, FINRA, American College) with official sources and verified dates, plus firm-level data, national and state rankings and market stats on

QR Planet QR Code MCP Server

qrplanet

QR Planet QR Code MCP Server - Hosted MCP server for QR Planet. Connect AI agents and MCP-compatible clients to create, update, design, route, and analyze dynamic QR Codes using your QR Planet API key.

1

CampaignStack

Run LinkedIn and email outreach from Claude, safely. Made for lead gen agencies, founders and medium-large companies. Every account gets enforced daily limits, its own proxy, and a review queue before anything sends.

SVGator

SVGator

Drive your SVGator account from any AI assistant. Prompt an animation, get an editable project back, and export it as SVG, Lottie, GIF, MP4, and more, then open it in the editor to finish by hand.

Advertise