彩云天气 MCP 服务器

这是一个用于彩云天气 API 的模型上下文协议 (MCP) 服务器。它提供了访问天气数据的工具，包括实时天气状况、预报和天气警报。

特性

• 实时天气状况
• 小时天气预报（最多 72 小时）
• 每日天气预报（最多 7 天）
• 天气警报
• 支持多种语言（中文、英文、日语）
• 令牌高效的紧凑响应格式

前提条件

• Node.js (v16 或更高版本)
• 一个彩云天气 API 令牌（从 彩云天气 API 文档 获取）

配置

{
  "mcpServers": {
    "caiyun-mcp-tools": {
      "command": "npx",
      "args": [
        "caiyun-mcp-tools"
      ],
      "env": {
        "CAIYUN_API_KEY": "your-caiyun-api-key"
      }
    }
  }
}

可用工具

该服务器提供以下可以通过 Cursor 访问的工具：

1. realtime-weather - 获取当前天气状况

   • 参数：
     • longitude (number): 经度坐标
     • latitude (number): 纬度坐标
     • lang (optional string): 响应语言（"zh_CN"、"en_US" 或 "ja"），默认为 "zh_CN"

2. hourly-forecast - 获取小时天气预报

   • 参数：
     • longitude (number): 经度坐标
     • latitude (number): 纬度坐标
     • hourlysteps (optional number): 要返回的小时预报数量（最大值：72）
     • lang (optional string): 响应语言（"zh_CN"、"en_US" 或 "ja"），默认为 "zh_CN"

3. daily-forecast - 获取每日天气预报

   • 参数：
     • longitude (number): 经度坐标
     • latitude (number): 纬度坐标
     • dailysteps (optional number): 要返回的每日预报数量（最大值：7）
     • lang (optional string): 响应语言（"zh_CN"、"en_US" 或 "ja"），默认为 "zh_CN"

4. weather-alerts - 获取活跃的天气警报

   • 参数：
     • longitude (number): 经度坐标
     • latitude (number): 纬度坐标
     • lang (optional string): 响应语言（"zh_CN"、"en_US" 或 "ja"），默认为 "zh_CN"

API 限制

根据官方彩云天气 API 文档：“API 接口仅支持返回过去一天内的历史数据。” 由于此限制，历史天气工具已从此软件包中删除。

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT