Aare.guru

Servidor MCP de Aare.guru

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la API de Aare.guru para obtener la temperatura del agua y las condiciones de natación del río Aare en Suiza.

Características

Este servidor MCP proporciona las siguientes herramientas:

• get_cities: Obtener la lista de todas las ubicaciones de monitoreo disponibles
• get_current_conditions: Obtener datos actuales completos (temperatura, caudal, pronósticos) para una ubicación específica
• get_today_summary: Obtener la temperatura actual mínima y la recomendación de natación
• get_widget_data: Obtener datos actuales de todas las ubicaciones a la vez
• get_historical_data: Obtener datos históricos de series temporales para temperatura, caudal y temperatura del aire

Requisitos

• Node.js 18 o superior

Instalación

Usando npx (Recomendado)

npx aareguru-mcp

Instalación Global

npm install -g aareguru-mcp
aareguru-mcp

Desarrollo Local

git clone <repository-url>
cd aareguru-mcp
npm install
npm start

Uso con Claude Desktop

Agrega lo siguiente a tu configuración MCP de Claude Desktop:

{
  "mcpServers": {
    "aareguru": {
      "command": "npx",
      "args": ["aareguru-mcp"]
    }
  }
}

O si está instalado globalmente:

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

Herramientas Disponibles

get_cities

Obtener una lista de todas las ubicaciones de monitoreo disponibles a lo largo del río Aare.

Parámetros: Ninguno requerido

• app (opcional): Identificador de la aplicación
• version (opcional): Número de versión
• values (opcional): Valores específicos a extraer

get_current_conditions

Obtener las condiciones actuales completas para una ubicación específica.

Parámetros:

• city (opcional, predeterminado: "bern"): Identificador de ubicación (por ejemplo, "bern", "thun")
• app (opcional): Identificador de la aplicación
• version (opcional): Número de versión
• values (opcional): Valores específicos a extraer

get_today_summary

Obtener un resumen mínimo con la temperatura actual y la recomendación de natación.

Parámetros:

• city (opcional, predeterminado: "bern"): Identificador de ubicación
• app (opcional): Identificador de la aplicación
• version (opcional): Número de versión
• values (opcional): Valores específicos a extraer

get_widget_data

Obtener datos actuales de todas las ubicaciones simultáneamente.

Parámetros:

• app (opcional): Identificador de la aplicación
• version (opcional): Número de versión
• values (opcional): Valores específicos a extraer

get_historical_data

Obtener datos históricos de series temporales para temperatura del agua, caudal y temperatura del aire.

Parámetros: (todos requeridos)

• city: Identificador de ubicación
• start: Fecha/hora de inicio (formato ISO, marca de tiempo, "yesterday", "-1 day", etc.)
• end: Fecha/hora de fin (formato ISO, marca de tiempo, "now", etc.)
• app (opcional): Identificador de la aplicación
• version (opcional): Número de versión
• values (opcional): Valores específicos a extraer

Consultas de Ejemplo

Una vez conectado a Claude Desktop, puedes hacer preguntas como:

• "¿Cuál es la temperatura actual del agua en Berna?"
• "Muéstrame todas las ubicaciones de monitoreo de Aare disponibles"
• "Obtén los datos históricos de Thun de la semana pasada"
• "¿Cuáles son las condiciones actuales de natación en todas las ubicaciones?"

Datos de la API

Este servidor se conecta a la API de Aare.guru (https://aare.guru), que proporciona:

• Temperatura actual del agua
• Caudal/tasas de descarga del agua
• Temperatura del aire
• Recomendaciones de natación y "Sprüche" (dichos)
• Pronósticos meteorológicos
• Datos históricos
• Múltiples ubicaciones de monitoreo a lo largo del río Aare

Licencia

Licencia Pública General de GNU v3.0

Créditos

Datos proporcionados por Aare.guru y el BAFU. La API está destinada únicamente para uso público no comercial.

Este servidor MCP no está afiliado oficialmente con Aare.guru, pero utiliza su API pública de acuerdo con sus términos de servicio.