cwa-mcp-server

MCP server that wraps the Central Weather Administration (CWA) open data API, allowing agents to query weather forecasts, earthquake reports, weather warnings, and typhoon alerts, and generate evacuation advisories.

Features

• Tool get_weather_forcast(county) — 36-hour weather forecast for a county/city

• Tool get_earthquake_report(limit) — The most recent N noticeable earthquake reports

• Tool get_weather_warning(county) — Currently active weather warnings for a county/city (heavy rain, strong winds, etc.)

• Tool get_typhoon_warning(limit) — The most recent N typhoon alerts

• Resource cwa://counties — List of valid county/city names

• Prompt evacuation_advisory(county) — Prompt template that generates an evacuation plan based on real-time weather/warning/earthquake/typhoon data

Related MCP server: mcp-cwa

Get an API Key

1. Register an account on the Meteorological Data Open Platform (email + password is enough, no approval needed)

2. After logging in, click "API Authorization Code" → "Get Authorization Code" to generate your key immediately

Installation (General Users)

Already published to PyPI; no need to clone this repo. In the MCP configuration of Claude Desktop / Claude Code, just specify uvx to run, and it will automatically fetch the package:

{
  "mcpServers": {
    "cwa-weather": {
      "command": "uvx",
      "args": ["cwa-mcp-server"],
      "env": { "CWA_API_KEY": "你申請到的授權碼" }
    }
  }
}

Or use the Claude Code CLI:

claude mcp add cwa-weather -e CWA_API_KEY=你申請到的授權碼 -- uvx cwa-mcp-server

Development (Modifying This Repo's Source Code)

git clone https://github.com/gary2376/cwa-mcp-server
cd cwa-mcp-server
uv sync
cp .env.example .env   # 填入 CWA_API_KEY

uv run python tests/test_client.py   # 最小自我檢查（不打真網路）
uv run mcp dev src/cwa_mcp/server.py # 本地用 inspector 手動測試 tools

Status

All four tools (weather forecast, earthquake report, weather warning, typhoon warning) have been validated against the live API with a real key, and have also been connected to Claude Code for real conversation-flow testing, correctly determining risk levels and providing specific recommendations. Published to PyPI and the MCP Server Registry.

Known pitfall fixed: The wheel originally uploaded in v0.1.0 was an empty shell package because uv_build defaults to guessing the module name from project.name (which becomes cwa_mcp_server), and that didn't match the actual source directory src/cwa_mcp/. This caused uvx cwa-mcp-server to fail with ModuleNotFoundError. This has been fixed by adding [tool.uv.build-backend] module-name = "cwa_mcp" to pyproject.toml and rebuilding to verify the wheel contents are correct.

License

MIT