Cwa MCP Server

🚀 臺灣中央氣象署 (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 密鑰。

安裝步驟

1. 使安裝腳本可執行：

chmod +x install.sh

2. 執行安裝腳本：

./install.sh

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

4. 重新啟動 Claude Desktop。
5. 開始在與 Claude 的對話中使用 CWA 氣象數據！

💻 使用示例

基礎用法

在 Claude 中，你可以通過以下示例來獲取氣象數據：

臺北市現在的天氣如何？

工具說明

get_weather_forecast

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

📦 使用 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 密鑰是否正確。
• 確保 Docker 已正確配置並運行。