caiyun-mcp-tools

🚀 酷云天气 MCP 服务器

酷云天气 MCP 服务器是一个为酷云天气 API 提供的模型上下文协议（MCP）服务器。它为用户提供了便捷访问天气数据的工具，涵盖实时天气状况、天气预报以及天气警报等信息。

🚀 快速开始

本服务器为用户提供了访问天气数据的工具，可获取实时天气、每小时和每天的天气预报以及天气警报等信息。

✨ 主要特性

• 🌡️ 实时天气状况：随时获取当前的天气情况。
• ⏱️ 每小时天气预报（最长72小时）：提前了解未来数小时的天气变化。
• 📅 每天天气预报（最长7天）：掌握未来一周的天气趋势。
• ⚠️ 天气警报：及时获取有效的天气警报信息。
• 🌐 支持多种语言（中文、英文、日文）：满足不同地区用户的需求。
• 💾 节省令牌的紧凑响应格式：有效节省 API 令牌资源。

📦 安装指南

先决条件

• Node.js（v16或更高版本）
• 酷云天气 API 令牌（从Caiyun Weather 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 (可选字符串): 响应语言（"zh_CN"、"en_US" 或 "ja"），默认为 "zh_CN"

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

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

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

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

4. weather-alerts - 获取有效的天气警报

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

API 限制

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

🤝 贡献

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

📄 许可证

MIT