Uso MCP Server¶

El servidor MCP permite usar Garúa desde clientes compatibles con Model Context Protocol. Es ideal cuando quieres pedir tareas en lenguaje natural y dejar que el cliente de IA llame las tools correctas.

Ejecutar servidor¶

garua-mcp

Configuración básica¶

{
  "mcpServers": {
    "garua": {
      "command": "garua-mcp"
    }
  }
}

Si el cliente no encuentra el comando, usa la ruta absoluta al ejecutable o al Python del entorno virtual. Puedes revisar Instalar y Configurar

Nota sobre descargas

Cuando pidas descargar datos, Garúa abrirá un navegador local para scrapear el sitio de SENAMHI y superar la verificación Cloudflare Turnstile cuando aparezca. Esto es esperado en la tool de descarga.

Prompts útiles¶

- Busca estaciones meteorologicas en Arequipa sobre 3000 msnm
- Qué estaciones hay cerca de lat -7.61, lon -77.82?
- Descarga datos de julio 2025 de la estacion Cabana
- Resume julio 2025 para la estacion 108047
- Compara marzo 2025 vs marzo 2026 para Cabana
- Valida la calidad de datos de julio 2025 para la estacion 108047

Flujo¶

graph LR
    A["Buscar o filtrar estaciones"] --> B["Confirmar código"]
    B --> C["Revisar disponibilidad 
    histórica"]
    C --> D{"¿Datos locales?"}
    D -- "No" --> E["Descargar datos"]
    D -- "Sí" --> F["Analizar datos"]
    E --> F

El análisis puede ser un resumen, una comparación entre periodos o una validación de calidad, según tu objetivo.

Referencia técnica¶

La lista completa de tools esta en Referencia de tools MCP. Esa referencia se genera desde los docstrings del código para mantenerla sincronizada con el servidor.