nausika

conectar · docs

Docs.

Última actualización

Qué es Nausika

Nausika es un servidor MCP que ancla un asistente de IA a datos marítimos reales: parte, mareas, lugares, derrota y geocodificación, para la navegación de recreo en la cuenca mediterránea.

El servidor está alojado en mcp.nausika.app. La autenticación usa OAuth 2.1 vía GitHub o Google. El transporte es Streamable HTTP según la especificación del Model Context Protocol.

Conectarse en tres pasos

Cinco minutos en Claude.ai. Sin claves API, sin SDK. Un tutorial más largo con URL para copiar vive en la página de inicio.

  1. Abrir el diálogo del conector

    Desde el menú de perfil en Claude.ai, ve a Customize → Connectors y haz clic en Add custom connector.

    Estilizado, no es captura. O usa el enlace directo para saltar al modal.

  2. Añadir Nausika y autenticarse

    Pon un nombre para mostrar y pega https://mcp.nausika.app como URL del servidor MCP remoto. Haz clic en Add, luego Connect para ejecutar OAuth con GitHub o Google.

  3. Activarlo en una conversación y preguntar

    En cualquier conversación abre el menú +, elige Connectors, activa Nausika y pregunta algo concreto. Las herramientas de Nausika se invocan automáticamente cuando la pregunta es marítima.

Verificar la integración

Cinco preguntas que un navegante puede pegar tal cual. Cada tarjeta muestra la cadena de herramientas que Nausika espera del asistente.

Planificación de travesía

Planifica una travesía de Génova a Bastia para mañana y dame las condiciones.

nausika_geocode nausika_marine_forecast nausika_sea_route nausika_calculator

Búsqueda de POI

Encuentra fondeaderos resguardados cerca de Portofino con al menos tres metros de calado.

nausika_geocode nausika_search_places

Mareas, California y Mediterráneo

Compara las mareas de mañana en la bahía de San Francisco con las de Cagliari.

Estación NOAA para la bahía de San Francisco; recurso a Open-Meteo para Cagliari.

nausika_geocode nausika_tides

Geocodificación fuera del Mediterráneo

¿Dónde está Lisboa, y la coordenada está sobre el agua?

La geocodificación recurre a OpenStreetMap Nominatim fuera del atlas curado.

nausika_geocode nausika_is_water

Contribución de un lugar

Quiero añadir un pequeño puerto deportivo que visité en el sur de Cerdeña. ¿Qué atributos debo aportar?

nausika_describe_place_schema nausika_is_water nausika_submit_proposal

Catálogo de herramientas

Veinte herramientas para usuarios autenticados: 9 accesibles sin login y 11 que requieren acceso. Los nombres son canónicos; pásalos tal cual desde cualquier cliente.

Herramientas base· 09 auth: anónimo
  1. nausika_marine_forecast Pronóstico marino y atmosférico para cualquier coordenada.
  2. nausika_tides Predicción de mareas y búsqueda de estaciones NOAA.
  3. nausika_search_places Búsqueda por proximidad, texto e ID con filtros.
  4. nausika_sea_route Derrota marítima sobre el grafo MARNET.
  5. nausika_geocode Geocodificación directa e inversa de lugares.
  6. nausika_calculator Calculadora offline para combustible y distancias.
  7. nausika_describe_place_schema Introspección del esquema para un tipo de lugar dado.
  8. nausika_is_water Verifica si una coordenada cae sobre el agua.
  9. nausika_convert_coordinates Convierte entre decimales, DMS y DM.
Usuario autenticado· 11 auth: usuario con sesión
  1. nausika_manage_boat_profile Crear, actualizar o eliminar un perfil de barco.
  2. nausika_get_boat_profile Recuperar el perfil de barco por defecto o uno nombrado.
  3. nausika_manage_favorite Añadir o quitar un lugar de favoritos.
  4. nausika_get_favorites Listar los lugares favoritos guardados con notas.
  5. nausika_manage_rating Valorar un lugar de una a cinco estrellas.
  6. nausika_get_ratings Ver valoraciones agregadas o las tuyas.
  7. nausika_manage_route Guardar una derrota simple o un itinerario de varias etapas.
  8. nausika_get_routes Listar o recuperar derrotas guardadas por ID.
  9. nausika_submit_proposal Enviar una propuesta de nuevo lugar o modificación.
  10. nausika_get_proposals Listar el estado de las propuestas del usuario.
  11. nausika_withdraw_proposal Retirar una propuesta aún pendiente.

Cobertura

  • El conjunto de datos curado es la cuenca mediterránea: puntos de interés, valoraciones, derrotas y datos contribuidos.
  • Parte, mareas, comprobación de costa y geocodificación aceptan cualquier coordenada y recurren a fuentes públicas globales (Open-Meteo, NOAA, OpenStreetMap) fuera del Mediterráneo.
  • Las búsquedas de lugares fuera del Mediterráneo suelen volver vacías hasta que las personas contribuyentes amplíen el atlas.

Convenciones de dominio

  • Distancias: millas náuticas (nm)
  • Velocidad: nudos (kt)
  • Profundidades y alturas: metros
  • Coordenadas: grados decimales, (latitud, longitud)
  • Por defecto: pronóstico a 3 días, radio de búsqueda 50 km, velocidad de crucero 6 kt

Límites del servicio

  • Radio de búsqueda: máximo 200 km, por defecto 50 km.
  • Resultados de búsqueda: máximo 100 por llamada, por defecto 30.
  • Horizonte de pronóstico: 16 días en el endpoint Forecast, 8 días en el endpoint Marine; preselección por defecto 3 días.
  • Rango de marea: configurable. El umbral de distancia a la estación NOAA ronda las 200 nm antes de que Nausika recurra a las mareas modeladas por Open-Meteo.
  • Limitación de tasa: gestionada a nivel de plataforma. Bajo carga sostenida el servidor devuelve HTTP 429 con Retry-After. Sé cortés.

Atribución y procedencia

Cada respuesta de herramienta incluye un array _attribution legible por máquina en el payload structuredContent y un pie Sources: legible por persona en el contenido textual, para que el asistente pueda mostrar el crédito al usuario final. Los detalles de licencia por fuente están en /credits.

Incidencias, soporte, seguridad