Cwa MCP Server

🚀 台湾中央气象署 (CWA) MCP 服务器

本项目是一个简单的模型上下文协议（Model Context Protocol, MCP）服务器，可将 Claude Desktop 连接到台湾中央气象署 (CWA) API，以获取气象数据，为用户提供便捷的气象信息服务。

✨ 主要特性

• 采用简单、轻量的 Node.js 实现，资源占用少。
• 易于配置，能轻松与 Claude Desktop 配合使用。
• 可获取所有台湾县市的 CWA 气象预报数据。

🚀 快速开始

获取 CWA API 密钥

1. 前往 https://opendata.cwa.gov.tw/user/authkey。
2. 登录账号（若没有账号，请先注册）。
3. 点击“获取授权码”按钮。
4. 复制你的 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 已正确配置并运行。