# ☀️ 台灣紫外線指數助手 (mcp-tw-uv)

這是一個 Model Context Protocol (MCP) 伺服器，專門提供台灣各地的**即時紫外線 (UV) 指數**以及**紫外線預報**，並根據指數提供防曬建議。

資料來源：[中央氣象署 (CWA) 開放資料平台](https://opendata.cwa.gov.tw/)。
- O-A0003-001 (紫外線指數日最大值預報)
- O-A0005-001 (紫外線指數觀測資料)

## ✨ 功能
- **即時觀測 (`get_uv_observation`)**：查詢全台測站目前的紫外線指數。
- **未來預報 (`get_uv_forecast`)**：查詢今天與明天的紫外線最大值預報。
- **防曬建議 (`get_protection_advice`)**：根據指數等級提供 WHO/CWA 標準的防護建議。

## 🛠 安裝與設定

### 1. 取得 API Key
你需要一個中央氣象署的授權碼 (API Key)。
- 前往 [CWA 開放資料平台](https://opendata.cwa.gov.tw/user/authkey) 註冊並取得授權碼。

### 2. 安裝依賴
本專案需要 Python 3.10+。

```bash
# 建立虛擬環境
python3 -m venv .venv
source .venv/bin/activate

# 安裝套件
pip install -r requirements.txt
```

---

## 🔌 MCP Client 設定

### Claude Desktop
請編輯 `~/Library/Application Support/Claude/claude_desktop_config.json`：

```json
{
  "mcpServers": {
    "tw-uv": {
      "command": "/Users/simonliuyuwei/clawd/projects/mcp-tw-uv/.venv/bin/python",
      "args": [
        "/Users/simonliuyuwei/clawd/projects/mcp-tw-uv/src/server.py"
      ],
      "env": {
        "CWA_API_KEY": "你的API_KEY"
      }
    }
  }
}
```

### Dive (Moltbot)
請在 Dive 的設定介面中新增一個 MCP Server：

- **Name**: `tw-uv`
- **Type**: `stdio`
- **Command**: `/Users/simonliuyuwei/clawd/projects/mcp-tw-uv/.venv/bin/python`
- **Arguments**: `/Users/simonliuyuwei/clawd/projects/mcp-tw-uv/src/server.py`
- **Environment Variables**:
    - `CWA_API_KEY`: `你的API_KEY` (請填入實際的 Key)

---

## 📝 開發說明
- `src/server.py`: MCP Server 入口點。
- `src/logic.py`: 資料擷取與處理邏輯。
- `src/config.py`: 設定檔 (API Key, URL)。

## ⚠️ 注意事項
- 請確保 API Key 正確，否則伺服器無法擷取資料。
- 紫外線觀測資料 (`O-A0005-001`) 並非所有測站都有提供。