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