集成指南

安装步骤

在开始之前，请确保你已经获取了API访问权限。可以在https://docs.caiyunapp.com/weather-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"

使用Claude Desktop进行配置

在claude_desktop_config.json文件中添加以下内容，具体路径可通过： 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文件中添加以下内容，具体路径可通过： 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（中国和美国标准）
    • 生活指数（UV和舒适度）

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

  • 参数：
    • lng：地理位置经度
    • lat：地理位置纬度
  • 返回信息包括：
    • 温度
    • 天气状况
    • 降水概率
    • 风速和风向

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

  • 参数：
    • lng：地理位置经度
    • lat：地理位置纬度
  • 返回信息包括：
    • 温度范围（最低/最高）
    • 天气状况
    • 降水概率

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

  • 参数：
    • lng：地理位置经度
    • lat：地理位置纬度
  • 返回信息包括：
    • 温度
    • 天气状况

• get_weather_alerts：获取指定位置的天气警报信息

  • 参数：
    • lng：地理位置经度
    • lat：地理位置纬度
  • 返回信息包括：
    • 警报标题
    • 警报代码
    • 警报状态
    • 警报描述

所有工具的使用均需提供地理位置的经纬度参数，并依赖有效的API令牌进行调用。