金大哥 - cwa-mcp-server MCP 详情

article

README

🚀 台湾中央气象署 (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 气象数据！

💻 使用示例

基础用法

在 Claude 中，通过 get_weather_forecast 工具，输入县市名称即可获取台湾未来 36 小时的气象预报。例如：

台北市现在的天气如何？

📦 使用 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 密钥是否正确。
确保 Docker 已正确配置并运行。

cwa-mcp-server