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