Roc Cwa MCP

🚀 臺灣中央氣象局 MCP 服務器

本項目搭建了一個模型上下文協議（MCP）服務器，該服務器與臺灣中央氣象局（CWA）的 API 接口相連接，能讓您輕鬆獲取臺灣地區的天氣數據。

English Version

🚀 快速開始

要使用此項目，您需先從中央氣象局獲取一個 API 密鑰：

• CWA 開放資料平臺：https://opendata.cwa.gov.tw/index
• API 文檔：https://opendata.cwa.gov.tw/dist/opendata-swagger.html
• API 密鑰申請指南：https://www.hlbh.hlc.edu.tw/resource/openfid.php?id=38959

✨ 主要特性

• 獲取臺灣各縣市未來 3 天的天氣預報數據
• 獲取臺灣各縣市未來 1 周的天氣預報數據
• 獲取過去 3 天的歷史降雨數據
• 自動進行數據清理和格式轉換
• 簡化的 API 輸出，僅包含必需信息

📦 安裝指南

系統要求

• Python 3.10+
• MCP CLI 1.6.0+
• uv 包管理器

安裝步驟

1. 確保安裝了 Python 3.10 或更高版本。
2. 使用 uv 安裝依賴項：

# 使用uv安裝項目依賴項
uv pip install -e .

💻 使用示例

啟動服務器

Windows 用戶

# 在命令提示符或PowerShell中執行
uv --directory 您的項目路徑 run src/server.py 您的API密鑰

Mac 和 Linux 用戶

# 在終端中執行
uv --directory 您的項目路徑 run src/server.py 您的API密鑰

可用 MCP 工具

此服務器提供以下三個主要工具：

基礎用法

get_3_days_weather

獲取指定縣市未來 3 天的天氣預報數據。

# 參數：
# - `location_name` (字符串)：縣市名稱，必須是有效的臺灣縣市名稱
# 有效縣市名稱包括：宜蘭縣、花蓮縣、臺東縣、澎湖縣、金門縣、連江縣、臺北市、新北市、桃園市、臺中市、臺南市、高雄市、基隆市、新竹縣、新竹市、苗栗縣、彰化縣、南投縣、雲林縣、嘉義縣、嘉義市、屏東縣

get_1_week_weather

獲取指定縣市未來 1 周的天氣預報數據。

# 參數：
# - `location_name` (字符串)：縣市名稱，必須是有效的臺灣縣市名稱

高級用法

get_rainfall_data

獲取過去 3 天的歷史降雨數據。

# 無額外參數需要提供。

📚 詳細文檔

API 數據來源

此項目使用了臺灣中央氣象局提供的以下開放數據 API：

• 未來 3 天預報：臺灣鄉鎮市天氣預報 - 3 日天氣預測（每 3 小時間隔）
• 未來 1 周預報：臺灣鄉鎮市天氣預報 - 1 週天氣預報
• 降雨數據：自動 Meteorological 站 - 降雨觀測資料