Aare.guru

Obtenha a temperatura da água e as condições de natação para o rio Aare, na Suíça.

Documentação

Servidor MCP Aare.guru

Um servidor Model Context Protocol (MCP) que fornece acesso à API Aare.guru para obter temperatura da água e condições de natação do rio Aare, na Suíça.

Recursos

Este servidor MCP fornece as seguintes ferramentas:

  • get_cities: Obter lista de todos os locais de monitoramento disponíveis
  • get_current_conditions: Obter dados atuais abrangentes (temperatura, fluxo, previsões) para um local específico
  • get_today_summary: Obter temperatura atual mínima e recomendação de natação
  • get_widget_data: Obter dados atuais de todos os locais de uma só vez
  • get_historical_data: Obter séries temporais históricas de temperatura, fluxo e temperatura do ar

Requisitos

  • Node.js 18 ou mais recente

Instalação

Usando npx (Recomendado)

npx aareguru-mcp

Instalação Global

npm install -g aareguru-mcp
aareguru-mcp

Desenvolvimento Local

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

Uso com Claude Desktop

Adicione o seguinte à sua configuração MCP do Claude Desktop:

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

Ou, se instalado globalmente:

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

Ferramentas Disponíveis

get_cities

Obter uma lista de todos os locais de monitoramento disponíveis ao longo do rio Aare.

Parâmetros: Nenhum obrigatório

  • app (opcional): Identificador do aplicativo
  • version (opcional): Número da versão
  • values (opcional): Valores específicos a extrair

get_current_conditions

Obter condições atuais abrangentes para um local específico.

Parâmetros:

  • city (opcional, padrão: "bern"): Identificador do local (ex.: "bern", "thun")
  • app (opcional): Identificador do aplicativo
  • version (opcional): Número da versão
  • values (opcional): Valores específicos a extrair

get_today_summary

Obter um resumo mínimo com temperatura atual e recomendação de natação.

Parâmetros:

  • city (opcional, padrão: "bern"): Identificador do local
  • app (opcional): Identificador do aplicativo
  • version (opcional): Número da versão
  • values (opcional): Valores específicos a extrair

get_widget_data

Obter dados atuais de todos os locais simultaneamente.

Parâmetros:

  • app (opcional): Identificador do aplicativo
  • version (opcional): Número da versão
  • values (opcional): Valores específicos a extrair

get_historical_data

Obter séries temporais históricas de temperatura da água, fluxo e temperatura do ar.

Parâmetros: (todos obrigatórios)

  • city: Identificador do local
  • start: Data/hora de início (formato ISO, timestamp, "yesterday", "-1 day", etc.)
  • end: Data/hora de término (formato ISO, timestamp, "now", etc.)
  • app (opcional): Identificador do aplicativo
  • version (opcional): Número da versão
  • values (opcional): Valores específicos a extrair

Exemplos de Consultas

Uma vez conectado ao Claude Desktop, você pode fazer perguntas como:

  • "Qual é a temperatura atual da água em Berna?"
  • "Mostre-me todos os locais de monitoramento Aare disponíveis"
  • "Obtenha os dados históricos de Thun da semana passada"
  • "Quais são as condições atuais de natação em todos os locais?"

Dados da API

Este servidor se conecta à API Aare.guru (https://aare.guru), que fornece:

  • Temperatura atual da água
  • Fluxo/vazão da água
  • Temperatura do ar
  • Recomendações de natação e "Sprüche" (ditos populares)
  • Previsões meteorológicas
  • Dados históricos
  • Múltiplos locais de monitoramento ao longo do rio Aare

Licença

GNU General Public License v3.0

Créditos

Dados fornecidos por Aare.guru e BAFU. A API é destinada apenas para uso público não comercial.

Este servidor MCP não é oficialmente afiliado ao Aare.guru, mas utiliza sua API pública de acordo com seus termos de serviço.