Skip to main content
Glama
cwa-mcp-server

cwa-mcp-server

by gary2376

cwa-mcp-server

MCP-сервер, оборачивающий открытый API данных Центрального метеорологического бюро (CWA), позволяющий агенту запрашивать прогнозы погоды, отчёты о землетрясениях, штормовые предупреждения, предупреждения о тайфунах и формировать рекомендации по эвакуации.

Возможности

  • Инструмент get_weather_forecast(county) — прогноз погоды для округа на ближайшие 36 часов

  • Инструмент get_earthquake_report(limit) — последние N заметных отчётов о землетрясениях

  • Инструмент get_weather_warning(county) — действующие в округе штормовые предупреждения (ливни, сильный ветер и т. д.)

  • Инструмент get_typhoon_warning(limit) — последние N предупреждений о тайфунах

  • Ресурс cwa://counties — список допустимых названий округов

  • Промпт evacuation_advisory(county) — шаблон промпта для генерации рекомендаций по эвакуации на основе текущих данных о погоде/предупреждениях/землетрясениях/тайфунах

Related MCP server: mcp-cwa

Получение API-ключа

  1. Зарегистрируйтесь на Платформе открытых метеорологических данных (email + пароль, без проверки)

  2. После входа нажмите «API-код авторизации» → «Получить код авторизации», ключ будет создан немедленно

Установка (для обычных пользователей)

Опубликовано на PyPI, клонировать этот репозиторий не нужно. В настройках MCP в Claude Desktop / Claude Code укажите выполнение через uvx — пакет будет загружен автоматически:

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

Или через CLI Claude Code:

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

Разработка (изменение исходного кода этого репозитория)

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

Статус

Все четыре инструмента (прогноз погоды, отчёты о землетрясениях, штормовые предупреждения, предупреждения о тайфунах) проверены на реальных ключах через онлайн-API, а также протестированы в диалогах с Claude Code — корректно определяют уровень риска и дают конкретные рекомендации. Опубликовано на PyPI и в реестре MCP-серверов.

Известные исправленные проблемы: в первоначально загруженном wheel v0.1.0 из-за того, что uv_build по умолчанию использует project.name для определения имени модуля (cwa_mcp_server), что не совпадает с фактическим каталогом исходного кода src/cwa_mcp/, был собран пустой пакет, и uvx cwa-mcp-server сразу выдавал ModuleNotFoundError. Исправлено добавлением [tool.uv.build-backend] module-name = "cwa_mcp" в pyproject.toml, после пересборки содержимое wheel проверено и корректно.

Лицензия

MIT

Available Tools

4 tools
get_earthquake_reportA

查詢最近 N 筆顯著有感地震報告(時間、地點、規模、深度)。

Inputs: limit. Returns: result

get_typhoon_warningA

查詢最近 N 筆颱風警報(命名、路徑強度描述、大雨/強風特報段落)。

Inputs: limit. Returns: result

get_weather_forecastA

查詢指定縣市未來 36 小時天氣預報(天氣現象、降雨機率、氣溫等)。

county 必須是 cwa://counties 清單中的完整縣市名稱,例如「臺北市」。

Inputs: county (required). Returns: result

get_weather_warningB

查詢指定縣市目前生效中的天氣特報(豪雨、強風等現象與有效時段)。

county 必須是 cwa://counties 清單中的完整縣市名稱,例如「臺北市」。

Inputs: county (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 4 tools

    Disambiguation4/5

    The four tools cover distinct domains: weather forecast, earthquake reports, weather warnings, and typhoon warnings. However, get_weather_warning and get_typhoon_warning could overlap during typhoons (heavy rain/strong wind warnings), but their descriptions focus on different parameters, so confusion is minimal.

    Naming Consistency4/5

    All tools follow a get_<domain>_<type> pattern, making them predictable. The only deviation is 'report' in get_earthquake_report versus 'forecast' and 'warning' in others, which is a minor inconsistency but does not harm readability.

    Tool Count5/5

    At 4 tools, the server is tightly scoped to the Central Weather Administration's primary data products. This is within the ideal 3-15 range, and each tool justifies its presence.

    Completeness4/5

    The server covers forecast, seismic events, and warnings comprehensively for its niche. Minor gaps exist, such as no get_current_weather or an explicit county-list tool (referenced externally via cwa://counties), but these are easily worked around and do not break core workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides access to Hong Kong Observatory weather data APIs, enabling retrieval of forecasts, earthquake info, tide data, and more via natural language.
      20
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides read-only access to Taiwan's Central Weather Administration (CWA) Open Data API, offering 36 tools across 7 categories including weather forecasts, observations, earthquakes, and astronomy.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables to access Taiwan Central Weather Administration data, including 3-day and 1-week weather forecasts for counties/cities and historical rainfall data.
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides real-time weather forecasts, weather warnings, and recent earthquake information in Taiwan via the Central Weather Administration's open data API.
      3
      MIT