Caiyun Weather

🚀 彩雲天氣 MCP 服務器

彩雲天氣 MCP 服務器基於彩雲天氣 API，遵循 Model Context Protocol (MCP)，為用戶提供全面且精準的天氣數據查詢服務。

🚀 快速開始

彩雲天氣 MCP 服務器能為你提供豐富的天氣數據。使用前，你需完成安裝和配置步驟。

✨ 主要特性

• 即時天氣數據：提供溫度、溼度、風速、氣壓等即時天氣信息。
• 分鐘級降水預報：精準預報未來2小時的降水情況。
• 小時級天氣預報：可查詢未來24小時或更長時間的天氣狀況。
• 每日天氣預報：獲取未來多天的天氣預報。
• 天氣預警信息：提供各類天氣預警。
• 地址查詢：支持通過地址查詢天氣（需配置高德地圖API）。
• 多語言支持：支持中文和英文。
• 單位制選擇：支持公制和英制。

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/marcusbai/caiyun-weather-mcp.git
cd caiyun-weather-mcp

2. 安裝依賴：

npm install

⚠️ 重要提示

本項目依賴於 Model Context Protocol (MCP) SDK，該SDK需要在運行環境中可用。MCP SDK通常由Claude或其他支持MCP的應用程序提供。

3. 構建項目：

npm run build

📚 詳細文檔

配置

在使用前，需要配置彩雲天氣API密鑰。如果需要地址查詢功能，還需要配置高德地圖API密鑰。

彩雲天氣API密鑰

1. 訪問 彩雲天氣 網站
2. 註冊並登錄賬戶
3. 創建應用並獲取 API Key

高德地圖API密鑰

1. 訪問 高德地圖開發者平臺
2. 登錄並創建新項目
3. 獲取API訪問令牌

使用說明

完成上述配置後，將以下信息添加到 config.js 文件中：

{
  "apiKey": "your_api_key", // 彩雲天氣 API Key
  "mapKey": "your_map_key"  // 高德地圖 API 令牌
}

參數說明

公共參數

天氣預警信息

GET /weather/alerts?lon=120.1234&lat=30.5678 HTTP/1.1
Host: your_domain

💻 使用示例

基礎用法

即時天氣查詢

GET /weather/current?lon=120.1234&lat=30.5678 HTTP/1.1
Host: your_domain

天氣預報查詢

GET /weather/forecast?lon=120.1234&lat=30.5678&days=5 HTTP/1.1
Host: your_domain

📄 許可證

本項目採用 MIT 許可證。