快速入门

1. 安装依赖

   • 安装 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"
     

2. 配置 API 密钥

   • 注册并获取彩云天气 API 密钥：https://docs.caiyunapp.com/weather-api/
   • 设置环境变量 CAIYUN_WEATHER_API_TOKEN。

3. 运行服务器

   • 使用 Claude Desktop 配置文件启动：

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

   • 本地调试运行：

     npx @modelcontextprotocol/inspector uv --directory /PATH/TO/PROJECT run mcp-caiyun-weather
     

4. 功能支持

   • 提供实时天气、逐小时预报、7天预报、历史天气及天气预警等功能。