Caiyun Weather MCP Server

Caiyun Weather MCP 服务

托管服务

Caiyun Weather 提供托管的 Streamable HTTP MCP 服务，因此你无需在本地安装或运行此软件包，即可使用天气工具。

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

外层配置格式取决于你的 MCP 客户端。开始之前，请注册并申请 Caiyun Weather API 密钥，然后在 X-Caiyun-API-Key 请求标头中传入该密钥。

设置说明

请先安装 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"

使用 Claude Desktop 进行设置

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uvx",
      "args": ["mcp-caiyun-weather"],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

向 Claude 提出需要天气信息的问题

例如：“北京现在的天气怎么样？”

本地/开发设置说明

使用 Claude Desktop 进行设置

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
    "caiyun-weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-caiyun-weather",
        "run",
        "mcp-caiyun-weather"
      ],
      "env": {
        "CAIYUN_WEATHER_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

调试

运行：

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

可用工具

• get_realtime_weather：获取特定地点的实时天气数据

  • 参数：
    • lng：地点的经度
    • lat：地点的纬度
  • 返回的详细信息包括：
    • 温度和体感温度
    • 天空状况
    • 湿度
    • 风速和风向
    • 降水强度
    • 空气质量指标（PM2.5、PM10、O3、SO2、NO2、CO）
    • AQI（中国和美国标准）
    • 生活指数（紫外线和舒适度）

• get_hourly_forecast：获取指定小时数的逐小时天气预报

  • 参数：
    • lng：地点的经度
    • lat：地点的纬度
    • hours：要返回的小时数（1–360，默认值为 72）
  • 返回的逐小时预报包括：
    • 温度
    • 天气状况
    • 降雨概率
    • 降水强度（mm/hr）
    • 风速和风向

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

  • 参数：
    • lng：地点的经度
    • lat：地点的纬度
  • 返回的每日预报包括：
    • 温度范围（最低/最高）
    • 天气状况
    • 降雨概率

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

  • 参数：
    • lng：地点的经度
    • lat：地点的纬度
  • 返回的历史数据包括：
    • 温度
    • 天气状况

• get_weather_alerts：获取特定地点的天气预警

  • 参数：
    • lng：地点的经度
    • lat：地点的纬度
  • 返回的天气预警包括：
    • 预警标题
    • 预警代码
    • 预警状态
    • 预警说明

注意：所有工具都需要有效的 Caiyun Weather API 令牌，该令牌必须设置在环境变量 CAIYUN_WEATHER_API_TOKEN 中。