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 已正确设置，并在设置变更后重新启动