trekking-mcp

English

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

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.