Caiyun Weather MCP Server

Name: Caiyun Weather MCP Server
Author: caiyunapp

@caiyunapp

代码仓库

关于 Caiyun Weather MCP Server

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

#caiyun #weather #api #colorfulclouds

基本信息

分类

媒体与设计

传输方式

stdio

发布者

caiyunapp

提交者

liluo

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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.

概览

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.

媒体与设计分类下的更多 MCP 服务器

Spotify MCP Server

marcelmarais

Lightweight MCP server for Spotify

384

Weather API MCP Server

TuanKiri

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Claude to retrieve and interpret real-time weather data. Discuss on Hacker News:

247