台灣中央氣象局 MCP 伺服器

此專案提供一個模型上下文協議 (MCP) 伺服器，它與台灣中央氣象局 (CWA) API 介接，讓您可以輕鬆存取台灣的天氣資料。

English

CWA API 資源

要使用此專案，您需要從中央氣象局取得 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 週天氣預報資料
• 取得過去三天的歷史降雨資料
• 自動資料清理和格式轉換
• 簡化的 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 your_project_path run src/server.py your_API_key

Mac 和 Linux 使用者

# 在終端機中執行
uv --directory your_project_path run src/server.py your_API_key

可用的 MCP 工具

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

1. get_3_days_weather

取得指定縣市的 3 天天氣預報資料。

參數：

• location_name (字串)：縣市名稱，必須是有效的台灣縣市名稱

有效的縣市名稱包括：宜蘭縣、花蓮縣、台東縣、澎湖縣、金門縣、連江縣、台北市、新北市、桃園市、台中市、台南市、高雄市、基隆市、新竹縣、新竹市、苗栗縣、彰化縣、南投縣、雲林縣、嘉義縣、嘉義市、屏東縣

2. get_1_week_weather

取得指定縣市的 1 週天氣預報資料。

參數：

• location_name (字串)：縣市名稱，必須是有效的台灣縣市名稱

3. get_historical_rainfall

取得過去三天的降雨資料。

無需參數。

資料格式

天氣預報資料格式

[
  {
    "ElementName": "Temperature",
    "Time": [
      ["2025-04-11T00:00", "21"],
      ["2025-04-11T01:00", "21"],
      ...
    ]
  },
  {
    "ElementName": "Relative Humidity",
    "Time": [
      ["2025-04-11T00:00", "90"],
      ["2025-04-11T01:00", "89"],
      ...
    ]
  },
  ...
]

降雨資料格式

{
  "rain_labels": ["Now", "Past10Min", "Past1hr", "Past3hr", "Past6Hr", "Past12hr", "Past24hr", "Past2days", "Past3days"],
  "stations": [
    {
      "name": "Station Name",
      "time": "Observation Time",
      "loc": "County,Town",
      "geo": [latitude, longitude],
      "rain": [current, past10min, past1hr, past3hr, past6hr, past12hr, past24hr, past2days, past3days]
    },
    ...
  ]
}

支援的天氣要素

3 天預報

• 溫度
• 相對濕度
• 體感溫度
• 舒適度指數
• 風向
• 風速
• 3 小時降水機率
• 天氣現象
• 綜合天氣描述

1 週預報

• 平均溫度
• 最高溫度
• 最低溫度
• 平均相對濕度
• 最高體感溫度
• 最低體感溫度
• 最高舒適度指數
• 最低舒適度指數
• 風速
• 風向
• 12 小時降水機率
• 紫外線指數
• 天氣現象
• 綜合天氣描述

API 資料來源

此專案使用台灣中央氣象局的以下開放資料 API：

• 3 天預報：臺灣各鄉鎮市區預報 - 3 天預報 (3 小時間隔)
• 1 週預報：臺灣各鄉鎮市區預報 - 1 週天氣預報
• 降雨資料：自動雨量站 - 雨量觀測資料