Cwa MCP Server

A Node.js server that connects Claude Desktop to the API of the Central Weather Bureau in Taiwan, providing weather forecast data for various counties and cities in Taiwan.

Research and data Location services #Weather data #API service #Claude plugin #Taiwan weather .JavaScript

rating : 2.5 points

downloads : 8.9K

update time : 2025-04-29

Open Site

Installation

Copy the following command to your Client for configuration

{
     "mcpServers": {
       "cwa": {
         "command": "node",
         "args": [
           "/path/to/cwa-server.js"
         ],
         "env": {
           "CWA_API_KEY": "CWA-1E740A28-FFDC-4186-BE0D-B02662F066EF"
         }
       }
     }
   }

{
     "mcpServers": {
       "cwa": {
         "command": "docker",
         "args": [
           "exec",
           "-i",
           "cwa-mcp-server",
           "node",
           "cwa-server.js"
         ]
       }
     }
   }

Note: Your key is sensitive information, do not share it with anyone.

🚀 Taiwan Central Weather Bureau (CWA) MCP Server

A simple Model Context Protocol (MCP) server that connects Claude Desktop to the Taiwan Central Weather Bureau (CWA) API to retrieve weather data.

✨ Features

Simple and lightweight Node.js implementation
Easy to configure and work with Claude Desktop
Retrieve CWA weather forecast data for all Taiwanese counties and cities

🚀 Quick Start

Obtain a CWA API key:
- Go to https://opendata.cwa.gov.tw/user/authkey
- Log in (register first if you don't have an account)
- Click the "Get Authorization Code" button
- Copy your API key
Make the installation script executable:
```
chmod +x install.sh
```
Execute the installation script:
```
./install.sh
```

Edit the configuration file located at ~/.config/claude/claude_desktop_config.json and add your CWA API key:

{
  "mcpServers": {
    "cwa": {
      "command": "node",
      "args": [
        "/path/to/cwa-server.js"
      ],
      "env": {
        "CWA_API_KEY": "CWA-1E740A28-FFDC-4186-BE0D-B02662F066EF"
      }
    }
  }
}

Restart Claude Desktop
Start using CWA weather data in your conversations with Claude!

💻 Usage Examples

`get_weather_forecast`

Get the 36 - hour weather forecast for Taiwan by county or city name.

Example usage in Claude:

What's the current weather in Taipei City?

📦 Installation with Docker

You can also use Docker to run this MCP server:

Create a docker-compose.yml file:

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=Your_CWA_API_Key
    restart: unless-stopped

Replace Your_CWA_API_Key with your actual CWA API key.

Update your Claude Desktop configuration:

{
  "mcpServers": {
    "cwa": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "cwa-mcp-server",
        "node",
        "cwa-server.js"
      ]
    }
  }
}

Start the Docker container:
```
docker-compose up -d
```
Restart Claude Desktop

📋 List of Available Regions

The following county and city names are supported:

Yilan County, Hualien County, Taitung County, Penghu County, Kinmen County, Lienchiang County
Taipei City, New Taipei City, Taoyuan City, Taichung City, Tainan City, Kaohsiung City
Keelung City, Hsinchu County, Hsinchu City, Miaoli County, Changhua County, Nantou County
Yunlin County, Chiayi County, Chiayi City, Pingtung County