CWA MCP 伺服器

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

功能特色

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

快速開始

1. 取得 CWA API 金鑰：

   • 前往 https://opendata.cwa.gov.tw/user/authkey
   • 登入（若沒有帳號，請先註冊）
   • 點擊「取得授權碼」按鈕
   • 複製你的 API 金鑰

2. 使安裝腳本可執行：

   chmod +x install.sh
   

3. 執行安裝腳本：

   ./install.sh
   

4. 編輯位於 ~/.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"
         }
       }
     }
   }
   

5. 重新啟動 Claude Desktop

6. 開始在與 Claude 的對話中使用 CWA 氣象資料！

可用工具

get_weather_forecast

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

在 Claude 中的使用範例：

台北市現在的天氣如何？

使用 Docker

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

1. 建立 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
   

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

3. 更新你的 Claude Desktop 設定：

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

4. 啟動 Docker 容器：

   docker-compose up -d
   

5. 重新啟動 Claude Desktop

可用地區列表

支援以下縣市名稱：

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

故障排除

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