Caiyun Weather MCP Server

产品定位

mcp-caiyun-weather 是一个基于彩云天气API的MCP服务，主要用于获取实时天气、小时预报、周预报、历史天气和天气警报等信息。

核心功能

• 获取实时天气数据
• 获取小时天气预报（未来72小时）
• 获取周天气预报（未来7天）
• 获取历史天气数据（过去24小时）
• 获取天气警报

适用场景

• 天气预报应用
• 出行规划
• 农业监测
• 气象研究

工具列表

• get_realtime_weather: 获取特定位置的实时天气数据
• 参数: lng（经度）, lat（纬度）

• 返回: 温度、湿度、风速和风向、降水强度、空气质量指标、AQI、生活指数

• get_hourly_forecast: 获取未来72小时的小时天气预报

• 参数: lng（经度）, lat（纬度）

• 返回: 温度、天气状况、降雨概率、风速和风向

• get_weekly_forecast: 获取未来7天的每日天气预报

• 参数: lng（经度）, lat（纬度）

• 返回: 温度范围（最低/最高）、天气状况、降雨概率

• get_historical_weather: 获取过去24小时的历史天气数据

• 参数: lng（经度）, lat（纬度）

• 返回: 温度、天气状况

• get_weather_alerts: 获取特定位置的天气警报

• 参数: lng（经度）, lat（纬度）
• 返回: 警报标题、警报代码、警报状态、警报描述

使用教程

使用依赖

在安装之前，请确保您已经申请了彩云天气API的访问权限。

安装uv：

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装教程

1. 在Claude Desktop的配置文件中添加以下内容：

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

1. 确保环境变量CAIYUN_WEATHER_API_TOKEN已设置为您的API密钥。

调试方式

运行以下命令进行调试：

npx @modelcontextprotocol/inspector \
      uv \
      --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather \
      run \
      mcp-caiyun-weather

常见问题解答

• 所有工具都需要在环境变量CAIYUN_WEATHER_API_TOKEN中设置有效的彩云天气API令牌。
• 确保您已经申请了彩云天气API的访问权限。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。