Caiyun Weather MCP Server

基本能力

产品定位

Caiyun Weather MCP Server 是一个天气数据服务，通过 MCP 协议提供彩云天气 API 的访问能力。

核心功能

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

适用场景

• 需要实时天气数据的应用
• 天气预报应用
• 天气警报系统
• 多语言天气服务

工具列表

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

2. 参数：

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

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

4. 参数：

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

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

6. 参数：

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

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

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

常见问题解答

• API 限制：根据彩云天气 API 文档，"API 接口仅支持返回过去一天的历史数据"。因此，历史天气工具已从本包中移除。

使用教程

使用依赖

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

安装教程

1. 确保已安装 Node.js v16 或更高版本。
2. 获取彩云天气 API 令牌。
3. 配置 MCP 服务器：

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

调试方式

1. 确保 CAIYUN_API_KEY 环境变量已正确设置。
2. 使用 npx caiyun-mcp-tools 命令启动服务。
3. 通过提供的工具名称和参数测试服务功能。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。