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_geocodenausika_marine_forecastnausika_sea_routenausika_calculator

Ricerca POI

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

nausika_geocodenausika_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_geocodenausika_tides

Geocodifica fuori dal Mediterraneo

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

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

nausika_geocodenausika_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_schemanausika_is_waternausika_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· 09auth: anonimo
  1. nausika_marine_forecastPrevisione marina e atmosferica per qualunque coordinata.
  2. nausika_tidesPredizioni di marea e ricerca delle stazioni NOAA.
  3. nausika_search_placesRicerca per prossimità, testo e ID con filtri.
  4. nausika_sea_routeCalcolo rotta marittima sul grafo MARNET.
  5. nausika_geocodeGeocodifica diretta e inversa di luoghi.
  6. nausika_calculatorCalcolatrice offline per carburante e distanze.
  7. nausika_describe_place_schemaIntrospezione dello schema per un dato tipo di luogo.
  8. nausika_is_waterVerifica se una coordinata cade sull'acqua.
  9. nausika_convert_coordinatesConversione fra decimali, DMS e DM.
Utente autenticato· 11auth: utente autenticato
  1. nausika_manage_boat_profileCrea, aggiorna o elimina un profilo barca.
  2. nausika_get_boat_profileRecupera il profilo barca predefinito o uno nominato.
  3. nausika_manage_favoriteAggiungi o togli un luogo dai preferiti.
  4. nausika_get_favoritesLista dei luoghi preferiti salvati con note.
  5. nausika_manage_ratingValuta un luogo da una a cinque stelle.
  6. nausika_get_ratingsVedi le valutazioni aggregate o le tue.
  7. nausika_manage_routeSalva una rotta singola o un itinerario a più tappe.
  8. nausika_get_routesLista o recupero delle rotte salvate per ID.
  9. nausika_submit_proposalInvia una proposta di nuovo luogo o di modifica.
  10. nausika_get_proposalsLista lo stato delle proposte dell'utente.
  11. nausika_withdraw_proposalRitira 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