what is CWA MCP Server?
CWA MCP Server is a lightweight Model Context Protocol (MCP) server that connects Claude Desktop to Taiwan's Central Weather Administration (CWA) API to retrieve weather data.
how to use CWA MCP Server?
To use CWA MCP Server, obtain a CWA API key, set up the server by executing installation scripts, and configure your Claude Desktop settings to include the API key.
key features of CWA MCP Server?
- Simple and lightweight Node.js implementation
- Easy to set up and integrate with Claude Desktop
- Access to weather forecast data for all cities in Taiwan
use cases of CWA MCP Server?
- Retrieving weather forecasts for specific cities in Taiwan.
- Integrating weather data into applications using Claude Desktop.
- Providing real-time weather updates in conversational interfaces.
FAQ from CWA MCP Server?
- How do I obtain a CWA API key?
You can obtain a CWA API key by registering on the CWA open data portal and following the instructions to get your authorization code.
- Can I run CWA MCP Server using Docker?
Yes! CWA MCP Server can be run using Docker by following the provided Docker setup instructions.
- What cities are supported by CWA MCP Server?
CWA MCP Server supports various cities in Taiwan, including Taipei, Kaohsiung, and Tainan.
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 已正確設定,並在設定變更後重新啟動