Caiyun Weather is a comprehensive weather data service that delivers real-time meteorological information, precipitation forecasts, and severe weather alerts via API. It integrates with the Caiyun Weather platform to provide detailed atmospheric data and lifestyle recommendations for locations across China and worldwide. Key features of Caiyun Weather: - Real-time weather metrics including temperature, humidity, wind speed, atmospheric pressure, and visibility - Minute-level precipitation forecasting for the next 2 hours with support for identifying rain, snow, sleet, and hail - Extended hourly and daily weather forecasts covering 24 hours or more - Severe weather warnings and alerts - Air quality tracking with 24-hour trend analysis and primary pollutant identification - Lifestyle indices offering guidance on exercise, travel, car washing, and clothing choices - Address-based weather queries with built-in coordinate data for 35 major Chinese cities including Beijing, Shanghai, Guangzhou, and Shenzhen - Multi-language support (Chinese and English) with both metric and imperial unit systems - Optional Amap/Gaode Maps API integration for geocoding custom addresses

彩云天气 MCP 服务器

基于彩云天气 API 的 Model Context Protocol (MCP) 服务器，提供天气数据查询功能。

功能特点

安装

安装 Smithery

通过 Smithery 安装 彩云天气 对于Claude的桌面应用：

npm install @smithery/cli -g
smithery install @pepperai/caiyun-weather-mcp

通过 NPX 使用

您可以直接通过 NPX 运行：

npx caiyun-weather-mcp --api-key=您的彩云天气API密钥

或者设置环境变量：

CAIYUN_API_KEY=您的密钥 npx caiyun-weather-mcp

从源码安装

1. 克隆仓库：

git clone https://github.com/marcusbai/caiyun-weather-mcp.git
cd caiyun-weather-mcp

2. 安装依赖：

npm install

> 注意：本项目依赖于 Model Context Protocol (MCP) SDK，该SDK需要在运行环境中可用。MCP SDK通常由Claude或其他支持MCP的应用程序提供。

3. 构建项目：

npm run build

配置

在使用前，需要配置彩云天气API密钥。地址查询功能支持内置城市缓存，高德地图API密钥为推荐配置。

彩云天气API密钥

1. 访问 彩云天气开发者中心 2. 注册并登录账号 3. 创建应用并获取API密钥

高德地图API密钥（推荐）

1. 访问 高德开放平台 2. 注册并登录账号 3. 创建应用并获取API密钥，需要启用"地理编码"服务

> 💡 提示：高德地图API密钥为推荐配置。系统内置了35个主要城市的坐标缓存，包括所有直辖市、省会城市和经济发达城市，无需额外配置即可使用。

地址解析功能

支持的城市

系统内置了以下35个主要城市的坐标缓存：

直辖市：北京、上海、天津、重庆

省会及主要城市：广州、深圳、杭州、南京、武汉、成都、西安、长沙、沈阳、大连、青岛、厦门、苏州、郑州、济南、哈尔滨、石家庄、太原、合肥、南昌、福州、南宁、昆明、贵阳、兰州、西宁、拉萨、呼和浩特、海口、银川、乌鲁木齐

智能地址匹配

支持多种地址格式和智能匹配：

地址解析策略

1. 缓存优先：内置城市坐标立即返回 2. API增强：配置高德API后支持任意地址 3. 降级处理：未知地址返回北京坐标并提示配置

配置MCP设置

编辑MCP设置文件，添加彩云天气MCP服务器配置：

{
  "mcpServers": {
    "caiyun-weather": {
      "command": "node",
      "args": ["完整路径/caiyun-weather-mcp/dist/index.js"],
      "env": {
        "CAIYUN_API_KEY": "您的彩云天气API密钥",
        "AMAP_API_KEY": "您的高德地图API密钥（推荐）"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

如果您通过 NPX 安装了本服务，可以使用以下配置：

{
  "mcpServers": {
    "caiyun-weather": {
      "command": "npx",
      "args": ["caiyun-weather-mcp"],
      "env": {
        "CAIYUN_API_KEY": "您的彩云天气API密钥",
        "AMAP_API_KEY": "您的高德地图API密钥（推荐）"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

使用示例

根据经纬度获取天气信息

caiyun-weather
get_weather_by_location
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "daily_steps": 5,
  "hourly_steps": 24,
  "language": "zh_CN",
  "unit": "metric"
}

根据地址获取天气信息

caiyun-weather
get_weather_by_address
{
  "address": "上海市",
  "daily_steps": 5,
  "hourly_steps": 24,
  "language": "zh_CN",
  "unit": "metric"
}

获取实时天气数据

caiyun-weather
get_realtime_weather
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}

获取分钟级降水预报

caiyun-weather
get_minutely_forecast
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}

获取小时级天气预报

caiyun-weather
get_hourly_forecast
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "hourly_steps": 24,
  "language": "zh_CN",
  "unit": "metric"
}

获取每日天气预报

caiyun-weather
get_daily_forecast
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "daily_steps": 5,
  "language": "zh_CN",
  "unit": "metric"
}

获取天气预警信息

caiyun-weather
get_weather_alert
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}

获取空气质量趋势

caiyun-weather
get_air_quality_trend
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}

获取详细生活指数

```

caiyun-weather get_detailed_life_index

{ "longitude": 116.3976, "latitude": 39.9075, "language": "zh_CN", "unit": "metric" }