CWA MCP 伺服器

一個簡單的模型內容協定 (Model Context Protocol, MCP) 伺服器，可將 Claude Desktop 連接到台灣中央氣象署 (CWA) API 以獲取氣象資料。

功能特色

簡單、輕量的 Node.js 實作
容易設定並與 Claude Desktop 配合使用
存取所有台灣縣市的 CWA 氣象預報資料

快速開始

取得 CWA API 金鑰：
- 前往 https://opendata.cwa.gov.tw/user/authkey
- 登入（若沒有帳號，請先註冊）
- 點擊「取得授權碼」按鈕
- 複製你的 API 金鑰
使安裝腳本可執行：
```
chmod +x install.sh
```
執行安裝腳本：
```
./install.sh
```

編輯位於 ~/.config/claude/claude_desktop_config.json 的設定檔，加入你的 CWA API 金鑰：

{
  "mcpServers": {
    "cwa": {
      "command": "node",
      "args": [
        "/path/to/cwa-server.js"
      ],
      "env": {
        "CWA_API_KEY": "CWA-1E740A28-FFDC-4186-BE0D-B02662F066EF"
      }
    }
  }
}

重新啟動 Claude Desktop
開始在與 Claude 的對話中使用 CWA 氣象資料！

可用工具

`get_weather_forecast`

透過縣市名稱獲取台灣未來 36 小時的氣象預報。

在 Claude 中的使用範例：

台北市現在的天氣如何？

使用 Docker

你也可以使用 Docker 來執行這個 MCP 伺服器：

建立 docker-compose.yml 檔案：

version: '3'
services:
  cwa-mcp-server:
    container_name: cwa-mcp-server
    image: node:18
    volumes:
      - ./:/app
    working_dir: /app
    command: node cwa-server.js
    environment:
      - CWA_API_KEY=你的_CWA_API_金鑰
    restart: unless-stopped

將 你的_CWA_API_金鑰 替換為你實際的 CWA API 金鑰

更新你的 Claude Desktop 設定：

{
  "mcpServers": {
    "cwa": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "cwa-mcp-server",
        "node",
        "cwa-server.js"
      ]
    }
  }
}

啟動 Docker 容器：
```
docker-compose up -d
```
重新啟動 Claude Desktop

可用地區列表

支援以下縣市名稱：

宜蘭縣、花蓮縣、臺東縣、澎湖縣、金門縣、連江縣
臺北市、新北市、桃園市、臺中市、臺南市、高雄市
基隆市、新竹縣、新竹市、苗栗縣、彰化縣、南投縣
雲林縣、嘉義縣、嘉義市、屏東縣

故障排除

確保已安裝 Node.js 18 或更高版本
檢查你的 CWA API 金鑰是否有效並正確設定在設定檔中
使用 ./test.sh 測試伺服器以確認其正常運作
確保 Claude Desktop 已正確設定，並在設定變更後重新啟動

中央氣象署天氣預報