Skip to content

彩云天气 MCP Server

Model Context Protocol (MCP) 是一个开放协议,用于在 AI 应用程序和外部数据源之间建立安全连接。彩云天气 MCP 服务器允许 AI 助手(如 Claude)直接访问彩云天气 API。

接入方式

使用前,请先注册并申请彩云天气 API Key

远程服务

直接连接彩云天气提供的 Streamable HTTP MCP 服务:

json
{
  "url": "https://mcp-weather.caiyunapp.com/mcp",
  "headers": {
    "X-Caiyun-API-Key": "YOUR_CAIYUN_WEATHER_API_KEY"
  }
}

外层配置格式取决于具体的 MCP 客户端。调用天气工具时,客户端需要通过 X-Caiyun-API-Key 请求头传入自己的彩云天气 API Key。

本地运行

也可以通过 uvx 在本地运行公开的 Python 包:

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

项目地址:https://github.com/caiyunapp/mcp-caiyun-weather

提供的工具

彩云天气 MCP Server 提供以下工具:

  • get_realtime_weather: 获取指定位置的实时天气数据(温度、湿度、风速风向、降水强度、空气质量、AQI、生活指数等)
  • get_hourly_forecast: 获取未来 72 小时的小时级天气预报
  • get_weekly_forecast: 获取未来 7 天的每日天气预报
  • get_historical_weather: 获取过去 24 小时的历史天气数据
  • get_weather_alerts: 获取指定位置的天气预警信息

本地安装、配置和开发说明请查看 GitHub 仓库