台湾中央气象署 (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 密钥是否正确
• 确保 Docker 已正确配置并运行