nausika

collega · docs

Docs.

Ultimo aggiornamento

Cos'è Nausika

Nausika è un server MCP che ancora un assistente AI a dati marittimi reali: meteo, maree, luoghi, rotte sul mare e geocodifica, per la navigazione da diporto nel bacino del Mediterraneo.

Il server è ospitato a mcp.nausika.app. L'accesso usa OAuth 2.1 via GitHub o Google. Il trasporto è Streamable HTTP come da specifica Model Context Protocol.

Collegati in tre passaggi

Cinque minuti in Claude.ai. Niente chiavi API, niente SDK. Un walkthrough più lungo con URL da copiare è sulla homepage.

  1. Apri la finestra del connettore

    Dal menu profilo in Claude.ai, vai a Customize → Connectors e clicca Add custom connector.

    Stilizzato, non uno screenshot. Oppure usa il link diretto per saltare al modale.

  2. Aggiungi Nausika e autenticati

    Imposta un nome visualizzato e incolla https://mcp.nausika.app come URL del server MCP remoto. Clicca Add, poi Connect per eseguire OAuth con GitHub o Google.

  3. Attivalo in una chat e chiedi

    In una qualunque chat apri il menu +, scegli Connectors, attiva Nausika e chiedi qualcosa di concreto. Gli strumenti di Nausika vengono richiamati automaticamente quando la domanda è marittima.

Verifica l'integrazione

Cinque domande che un navigatore può incollare alla lettera. Ogni scheda mostra la catena di strumenti che Nausika si aspetta dall'assistente.

Pianificazione della rotta

Pianifica una rotta da Genova a Bastia per domani e dimmi le condizioni.

nausika_geocode nausika_marine_forecast nausika_sea_route nausika_calculator

Ricerca POI

Trova ancoraggi riparati vicino a Portofino con almeno tre metri di fondale.

nausika_geocode nausika_search_places

Maree, USA e Mediterraneo

Confronta le maree di domani nella baia di San Francisco con quelle al largo di Cagliari.

Stazione NOAA per la baia di San Francisco; fallback Open-Meteo per Cagliari.

nausika_geocode nausika_tides

Geocodifica fuori dal Mediterraneo

Dov'è Lisbona, e la coordinata è sull'acqua?

La geocodifica ricade su OpenStreetMap Nominatim fuori dall'atlante curato.

nausika_geocode nausika_is_water

Contributo di un luogo

Voglio aggiungere una piccola marina che ho visitato nel sud della Sardegna. Quali attributi devo fornire?

nausika_describe_place_schema nausika_is_water nausika_submit_proposal

Catalogo strumenti

Venti strumenti per gli utenti autenticati: 9 accessibili senza login e 11 che richiedono l'accesso. I nomi sono canonici; usali alla lettera da qualunque client.

Strumenti base· 09 auth: anonimo
  1. nausika_marine_forecast Previsione marina e atmosferica per qualunque coordinata.
  2. nausika_tides Predizioni di marea e ricerca delle stazioni NOAA.
  3. nausika_search_places Ricerca per prossimità, testo e ID con filtri.
  4. nausika_sea_route Calcolo rotta marittima sul grafo MARNET.
  5. nausika_geocode Geocodifica diretta e inversa di luoghi.
  6. nausika_calculator Calcolatrice offline per carburante e distanze.
  7. nausika_describe_place_schema Introspezione dello schema per un dato tipo di luogo.
  8. nausika_is_water Verifica se una coordinata cade sull'acqua.
  9. nausika_convert_coordinates Conversione fra decimali, DMS e DM.
Utente autenticato· 11 auth: utente autenticato
  1. nausika_manage_boat_profile Crea, aggiorna o elimina un profilo barca.
  2. nausika_get_boat_profile Recupera il profilo barca predefinito o uno nominato.
  3. nausika_manage_favorite Aggiungi o togli un luogo dai preferiti.
  4. nausika_get_favorites Lista dei luoghi preferiti salvati con note.
  5. nausika_manage_rating Valuta un luogo da una a cinque stelle.
  6. nausika_get_ratings Vedi le valutazioni aggregate o le tue.
  7. nausika_manage_route Salva una rotta singola o un itinerario a più tappe.
  8. nausika_get_routes Lista o recupero delle rotte salvate per ID.
  9. nausika_submit_proposal Invia una proposta di nuovo luogo o di modifica.
  10. nausika_get_proposals Lista lo stato delle proposte dell'utente.
  11. nausika_withdraw_proposal Ritira una proposta ancora in attesa.

Copertura

  • Il dataset curato è il bacino del Mediterraneo: punti d'interesse, valutazioni, rotte e dati contribuiti.
  • Meteo, maree, controllo di costa e geocodifica accettano qualsiasi coordinata e ripiegano su fonti pubbliche globali (Open-Meteo, NOAA, OpenStreetMap) fuori dal Mediterraneo.
  • Le ricerche di luoghi fuori dal Mediterraneo di norma tornano vuote finché i contributori non estendono l'atlante.

Convenzioni di dominio

  • Distanze: miglia nautiche (nm)
  • Velocità: nodi (kt)
  • Fondali e altezze: metri
  • Coordinate: gradi decimali, (latitudine, longitudine)
  • Default: previsione a 3 giorni, raggio di ricerca 50 km, velocità di crociera 6 kt

Limiti del servizio

  • Raggio di ricerca: massimo 200 km, default 50 km.
  • Risultati di ricerca: massimo 100 per chiamata, default 30.
  • Orizzonte di previsione: 16 giorni sull'endpoint Forecast, 8 giorni sull'endpoint Marine; il preset di default è 3 giorni.
  • Intervallo marea: configurabile. La soglia di distanza dalla stazione NOAA è intorno a 200 nm prima che Nausika ripieghi sulle maree modellate da Open-Meteo.
  • Rate limiting: gestito a livello di piattaforma. Sotto carico sostenuto il server torna HTTP 429 con Retry-After. Sii cortese.

Attribuzione e provenienza

Ogni risposta degli strumenti include un array _attribution leggibile dalla macchina sul payload structuredContent, e un piè di pagina Sources: leggibile dall'utente, in modo che l'assistente possa mostrare la fonte. I dettagli di licenza per fonte sono su /credits.

Problemi, supporto, sicurezza