彩云天气MCP

Name: 彩云天气MCP
Author: marcusbai

作者：marcusbai6 星标更新：2025-11-07

安装使用来源：spider==github.com

项目介绍

Cloud Weather MCP Server

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

功能

实时天气数据：温度、湿度、风速、气压、能见度等
分钟级降水预报：未来2小时内的降水情况
小时天气预报：未来24小时或更长时间的天气预报
日天气预报：未来几天的天气预报
天气预警信息：各种天气警告
空气质量趋势：24小时内的空气质量变化趋势及主要污染物分析
详细生活指数：运动、旅行、洗车、穿衣等生活方式建议
降水类型识别：区分雨、雪、冰雹、冻雨等降水类型
地址查询：支持通过地址查询天气，内置35个主要城市的坐标缓存，无需额外配置即可使用
多语言支持：支持中文和英文
单位系统选择：支持公制和英制单位

安装

安装Smithery

通过Smithery安装Caiyun Weather到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

从源代码安装

克隆仓库：

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

安装依赖：

npm install

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

构建项目：

npm run build

配置

在使用前，需要配置Caiyun Weather API密钥。地址查询功能支持内置城市缓存，建议配置Amap API密钥。

Caiyun Weather API密钥

访问Caiyun Weather开发者中心
注册并登录账户
创建应用程序并获取API密钥

高德地图API密钥（推荐）

访问高德开放平台
注册并登录账户
创建应用程序并获取API密钥，需开启“地理编码”服务

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

地址解析功能

支持的城市

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

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

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

智能地址匹配

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

标准格式：上海、上海市
详细地址：上海市浦东新区、北京市朝阳区
城市别名：魔都→ 上海帝都→ 北京羊城→ 广州鹏城→ 深圳等

地址解析策略

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

配置MCP设置

编辑MCP设置文件，添加color cloud weather 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": []
    }
  }
}

使用示例

根据经纬度获取天气信息

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_weather_by_location</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "daily_steps": 5,
  "hourly_steps": 24,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

根据地址获取天气信息

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_weather_by_address</tool_name>
<arguments>
{
  "address": "上海市",
  "daily_steps": 5,
  "hourly_steps": 24,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

获取实时天气数据

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_realtime_weather</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

获取分钟级降水预报

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_minutely_forecast</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

获取小时天气预报

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_hourly_forecast</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "hourly_steps": 24,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

获取日天气预报

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_daily_forecast</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "daily_steps": 5,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

获取天气预警信息

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_weather_alert</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

获取空气质量趋势

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_air_quality_trend</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

获取详细生活指数

<use_mcp_tool>
<server_name>caiyun-weather</server_name>
<tool_name>get_detailed_life_index</tool_name>
<arguments>
{
  "longitude": 116.3976,
  "latitude": 39.9075,
  "language": "zh_CN",
  "unit": "metric"
}
</arguments>
</use_mcp_tool>

参数描述

常用参数

longitude：经度
latitude：纬度
address：地址（仅用于get_weather_by_address）
daily_steps：每日预报天数（1-15，默认5）
hourly_steps：每小时预报次数（1-360，默认24）
language：语言（zh_CN 或 en_US，默认 zh_CN）
unit：单位系统（metric 或 imperial，默认 metric）

许可证

MIT