Skip to main content
Glama

trekking-mcp

CI PyPI MCP Registry

English

Demo: ispezione del server MCP

Server MCP per l'escursionismo sul territorio italiano: sentieri numerati, rifugi e bivacchi, bollettini valanghe e meteo di quota, da usare con un assistente AI.

Avvertenza. I bollettini valanghe sono documenti ufficiali di sicurezza. Quando li riporta, non li interpreta e non valuta il rischio. Non sostituisce il bollettino integrale, la formazione specifica, ne' il giudizio sul terreno. Usalo per preparare una gita, mai per decidere se farla.

Cosa puoi fare

Chiedere all'assistente, ad esempio:

  • dove sono i sentieri vicino a un paese o a una cima

  • dettagli e profilo altimetrico di un percorso

  • rifugi e bivacchi nella zona

  • meteo in quota e bollettino valanghe per la data della gita

Related MCP server: Mountaineers MCP Server

Come usarlo

Serve uv. Nessuna API key.

uvx trekking-mcp

Cursor / Claude Code

Aggiungi questo blocco alla configurazione MCP:

{
  "mcpServers": {
    "trekking": {
      "command": "uvx",
      "args": ["trekking-mcp"]
    }
  }
}

Poi chiedi qualcosa come: «Che sentieri ci sono verso il Monte Rosso partendo da Oropa?»

Tool

Tool

A cosa serve

cerca_localita

Trova le coordinate di un toponimo

cerca_sentieri

Sentieri numerati intorno a un punto

sentieri_verso_localita

Da un nome di luogo: sentieri e rifugi vicini (il punto di partenza consigliato)

dettaglio_sentiero

Dettagli di un sentiero

profilo_altimetrico

Lunghezza e dislivello

cerca_ricoveri

Rifugi, bivacchi e ripari

zona_valanghe_da_coordinate

Zona del bollettino valanghe da un punto

bollettino_valanghe

Bollettino corrente di una zona

meteo_quota

Previsione oraria in quota

valuta_gita

Riassume sentiero, meteo e valanghe per una data

Fonti

Dati da OpenStreetMap, AINEVA, WSL-SLF (Svizzera), Open-Meteo, EAWS Regions e Nominatim.

I sentieri numerati CAI sono quelli mappati dalla community OSM: la copertura non e' uniforme e un sentiero assente dalla mappa non significa che non esista.

Licenza

MIT.

Per contribuire o dettagli di sviluppo: DEVELOPMENT.md.

Available Tools

9 tools
bollettino_valangheBollettino valangheA
Read-only

Restituisce il bollettino valanghe corrente per una zona (formato CAAML v6, profilo EAWS). Le zone AINEVA hanno identificativi tipo 'IT-21-...'. IMPORTANTE: i dati vanno sempre presentati con il rimando al bollettino ufficiale; non sono una valutazione del rischio.

Inputs: zona_id (required), lingua, provider. Returns: Bollettino valanghe normalizzato da CAAML v6 (profilo EAWS).

cerca_localitaCerca un luogo per nomeA
Read-only

Converte un toponimo in coordinate: nomi di rifugi, cime, valichi, paesi e frazioni. Punto di partenza naturale quando l'utente nomina un posto invece di fornire coordinate. Restituisce piu' candidati: se sono ambigui, chiedi conferma prima di procedere.

Inputs: nome (required), limite. Returns: result

cerca_ricoveriCerca rifugi e bivacchiA
Read-only

Cerca rifugi gestiti, bivacchi e ripari entro un raggio da un punto. I dati su posti letto e contatti dipendono dalla mappatura OSM e possono mancare.

Inputs: lat (required), lon (required), raggio_km. Returns: result

cerca_sentieriCerca sentieri escursionisticiA
Read-only

Cerca sentieri escursionistici numerati in una zona, per riquadro geografico o attorno a un punto. Il numero del sentiero va nel parametro ref (es. '103'). Fonte: relation OSM route=hiking.

Inputs: lat (required), lon (required), ref, limite, +3 more. Returns: result

dettaglio_sentieroDettaglio di un sentieroA
Read-only

Restituisce i dati completi di un sentiero dato l'ID della sua relation OSM.

Inputs: osm_relation_id (required). Returns: result

meteo_quotaMeteo di quotaB
Read-only

Previsione oraria per un punto, corretta per l'elevazione indicata. Include zero termico, raffiche e neve fresca.

Inputs: lat (required), lon (required), quota_m (required), data, +1 more. Returns: result

profilo_altimetricoProfilo altimetrico di un sentieroA
Read-only

Calcola lunghezza reale e dislivello positivo e negativo di un sentiero, campionando la quota lungo il tracciato. Piu' lento degli altri tool perche' scarica la geometria completa: usalo quando serve capire l'impegno di una gita, non nelle ricerche.

Inputs: osm_relation_id (required), passo_m. Returns: Profilo di un percorso: quote campionate e dislivelli cumulati.

valuta_gitaRaccogli le condizioni per una gitaA
Read-only

Dato un sentiero e una data, raccoglie in un colpo solo: dati del sentiero, rifugi e bivacchi vicini, bollettino valanghe della zona e meteo di quota. Restituisce fatti normalizzati e segnali di attenzione, NON un verdetto vai/non-vai: la decisione resta a chi va in montagna.

Inputs: osm_relation_id (required), data, con_profilo, zona_valanghe, +1 more. Returns: Output composito: mette insieme sentiero, ricoveri, bollettino e meteo. Deliber…

zona_valanghe_da_coordinateTrova la zona del bollettino valangheA
Read-only

Dato un punto, individua la micro-regione EAWS a cui appartiene, cioe' la zona per cui viene emesso il bollettino valanghe. Usa questo tool prima di bollettino_valanghe invece di indovinare l'identificativo della zona.

Inputs: lat (required), lon (required). Returns: Micro-regione EAWS identificata a partire da un punto.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool maps to a distinct resource or workflow step: trail search, trail detail, shelters, places, avalanche zone, bulletin, weather, profile, and aggregate trip evaluation. The related avalanche tools are explicitly sequenced, and valuta_gita is clearly framed as an aggregation rather than a duplicate.

    Naming Consistency3/5

    All names are Italian snake_case venom, but the pattern is mixed: some are verb-led (cerca_sentieri, cerca_localita, valuta_gita) while others are noun-led phrases (dettaglio_sentiero, profilo_altimetrico, bollettino_valanghe). The naming is readable but not uniformly consistent.

    Tool Count5/5

    Nine tools is well-scoped for a trekking planning domain. Each tool covers a meaningful capability, and none feel redundant or unnecessary.

    Completeness5/5

    The set covers the full trip-planning workflow: place lookup, trail search and detail, elevation profile, shelter search, avalanche zone and bulletin, weather at elevation, and an aggregate evaluation. There are no obvious dead ends or missing core operations for this read-only domain.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers