cwa-mcp-server

Servidor MCP que envuelve la API de datos abiertos de la Agencia Meteorológica Central (CWA), permitiendo a los agentes consultar pronósticos del tiempo, informes de terremotos, avisos meteorológicos, alertas de tifones y generar recomendaciones de evacuación.

Funciones

• Tool get_weather_forecast(county) — Pronóstico del tiempo para las próximas 36 horas en el condado/ciudad

• Tool get_earthquake_report(limit) — Informe de los últimos N terremotos perceptibles significativos

• Tool get_weather_warning(county) — Avisos meteorológicos actualmente activos para el condado/ciudad (lluvias torrenciales, vientos fuertes, etc.)

• Tool get_typhoon_warning(limit) — Alertas de tifón de los últimos N

• Resource cwa://counties — Lista de nombres válidos de condados/ciudades

• Prompt evacuation_advisory(county) — Plantilla de prompt para generar recomendaciones de evacuación basadas en datos en tiempo real de clima/avisos/terremotos/tifones

Related MCP server: mcp-cwa

Obtener una clave de API

1. Regístrese en Plataforma de datos abiertos meteorológicos (solo se necesita correo electrónico y contraseña, sin revisión)

2. Después de iniciar sesión, haga clic en «Código de autorización de API» → «Obtener código de autorización» para generar la clave inmediatamente

Instalación (usuarios generales)

Se ha publicado en PyPI, no es necesario clonar este repositorio. En la configuración de MCP de Claude Desktop / Claude Code, especifique uvx para ejecutarlo y descargará el paquete automáticamente:

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

O con la CLI de Claude Code:

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

Desarrollo (modificar el código fuente de este repositorio)

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

Estado

Las cuatro herramientas (pronóstico del tiempo, informe de terremotos, avisos meteorológicos, alertas de tifones) han sido verificadas con claves reales contra la API en línea, y también se han probado con Claude Code en flujos de conversación reales, pudiendo evaluar correctamente los niveles de riesgo y proporcionar recomendaciones concretas. Se ha publicado en PyPI y en el Registro de Servidores MCP.

Errores conocidos corregidos: El wheel subido inicialmente en v0.1.0, debido a que uv_build usa por defecto project.name para adivinar el nombre del módulo (cwa_mcp_server), no coincidía con el directorio real del código fuente src/cwa_mcp/, empaquetando un paquete vacío, y uvx cwa-mcp-server generaba directamente un ModuleNotFoundError. Se ha corregido añadiendo [tool.uv.build-backend] module-name = "cwa_mcp" en pyproject.toml, y se ha reconstruido y verificado que el contenido del wheel es correcto.

Licencia

MIT