Servidor MCP de mareas y corrientes de la NOAA

Name: noaa-tidesandcurrents-mcp
Author: RyanCardin15

insignia de herrería

Este es un servidor MCP (Protocolo de contexto de modelo) que proporciona herramientas para interactuar con la API de mareas y corrientes de la NOAA utilizando el marco FastMCP.

Características

Recuperación de datos de nivel de agua (en tiempo real e históricos)
Predicciones de mareas (altas/bajas o basadas en intervalos)
Datos actuales (en tiempo real e históricos)
Predicciones actuales
Recuperación de metadatos de la estación
Viento, temperatura del aire, temperatura del agua y otros datos meteorológicos
Información sobre las fases lunares (pasadas, presentes y futuras)
Datos de salida/puesta del sol y posición (pasado, presente y futuro)

Related MCP server: Node.js MCP Weather Server

Prerrequisitos

Node.js (v18 o superior)
npm o hilo

Configuración

Instalación mediante herrería

Para instalar NOAA Tides and Currents para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @RyanCardin15/tidesandcurrents --client claude

Instalación manual

Clonar este repositorio
Instalar dependencias

npm install

Cree un archivo .env basado en el archivo .env.example :

# Server Configuration PORT=3000 # Transport type (stdio or sse) TRANSPORT_TYPE=stdio # NOAA API application name for identification (recommended) APPLICATION_NAME=YourAppName

Construir el código TypeScript

npm run build

Iniciar el servidor

npm start

Uso

Este servidor MCP se puede utilizar con cualquier host MCP como Claude Desktop, lo que le permite utilizar la API de mareas y corrientes de la NOAA a través del protocolo MCP.

También puedes probarlo directamente usando la herramienta de línea de comandos fastmcp :

npx fastmcp dev dist/index.js

O bien, puede utilizar el Inspector MCP:

npx fastmcp inspect dist/index.js

Herramientas disponibles

Niveles de agua

get_water_levels - Obtener datos del nivel de agua para una estación
- Parámetros:
  - station (cadena) - ID de la estación
  - date (cadena, opcional): fecha para la que se recuperarán los datos ("hoy", "más reciente", "reciente" o fecha específica)
  - begin_date (cadena, opcional) - Fecha de inicio (AAAAMMDD o MM/DD/AAAA)
  - end_date (cadena, opcional) - Fecha de finalización (AAAAMMDD o MM/DD/AAAA)
  - range (número, opcional) - Número de horas para recuperar datos
  - datum (cadena, opcional) - Dato a utilizar (MLLW, MSL, etc.)
  - units (cadena, opcional) - Unidades a utilizar ("inglés" o "métrico")
  - time_zone (cadena, opcional) - Zona horaria (gmt, lst, lst_ldt)
  - format (cadena, opcional) - Formato de salida (json, xml, csv)

Predicciones de mareas

get_tide_predictions - Obtener datos de predicción de mareas
- Parámetros:
  - station (cadena) - ID de la estación
  - begin_date (cadena) - Fecha de inicio (AAAAMMDD o MM/DD/AAAA)
  - end_date (cadena) - Fecha de finalización (AAAAMMDD o MM/DD/AAAA)
  - datum (cadena, opcional) - Dato a utilizar (MLLW, MSL, etc.)
  - units (cadena, opcional) - Unidades a utilizar ("inglés" o "métrico")
  - time_zone (cadena, opcional) - Zona horaria (gmt, lst, lst_ldt)
  - interval (cadena, opcional) - Intervalo (hilo, hl, h o un número para minutos)
  - format (cadena, opcional) - Formato de salida (json, xml, csv)

Corrientes

get_currents - Obtener datos de corrientes para una estación
- Parámetros:
  - station (cadena) - ID de la estación
  - date (cadena, opcional): fecha para la que se recuperarán los datos ("hoy", "más reciente", "reciente" o fecha específica)
  - begin_date (cadena, opcional) - Fecha de inicio (AAAAMMDD o MM/DD/AAAA)
  - end_date (cadena, opcional) - Fecha de finalización (AAAAMMDD o MM/DD/AAAA)
  - bin (número, opcional) - Número de contenedor
  - units (cadena, opcional) - Unidades a utilizar ("inglés" o "métrico")
  - time_zone (cadena, opcional) - Zona horaria (gmt, lst, lst_ldt)
  - format (cadena, opcional) - Formato de salida (json, xml, csv)

Predicciones actuales

get_current_predictions - Obtener predicciones actuales
- Parámetros:
  - station (cadena) - ID de la estación
  - date (cadena, opcional): fecha para la que se recuperarán los datos ("hoy", "más reciente", "reciente" o fecha específica)
  - begin_date (cadena, opcional) - Fecha de inicio (AAAAMMDD o MM/DD/AAAA)
  - end_date (cadena, opcional) - Fecha de finalización (AAAAMMDD o MM/DD/AAAA)
  - bin (número, opcional) - Número de contenedor
  - interval (cadena, opcional) - Intervalo (MAX_SLACK o un número para minutos)
  - vel_type (cadena, opcional) - Tipo de velocidad (speed_dir o predeterminado)
  - units (cadena, opcional) - Unidades a utilizar ("inglés" o "métrico")
  - time_zone (cadena, opcional) - Zona horaria (gmt, lst, lst_ldt)
  - format (cadena, opcional) - Formato de salida (json, xml, csv)

Datos meteorológicos

get_meteorological_data - Obtener datos meteorológicos
- Parámetros:
  - station (cadena) - ID de la estación
  - product (cadena) - Producto (temperatura del aire, viento, etc.)
  - date (cadena, opcional): fecha para la que se recuperarán los datos ("hoy", "más reciente", "reciente" o fecha específica)
  - begin_date (cadena, opcional) - Fecha de inicio (AAAAMMDD o MM/DD/AAAA)
  - end_date (cadena, opcional) - Fecha de finalización (AAAAMMDD o MM/DD/AAAA)
  - units (cadena, opcional) - Unidades a utilizar ("inglés" o "métrico")
  - time_zone (cadena, opcional) - Zona horaria (gmt, lst, lst_ldt)
  - format (cadena, opcional) - Formato de salida (json, xml, csv)

Información de la estación

get_stations - Obtener lista de estaciones
- Parámetros:
  - type (cadena, opcional) - Tipo de estación (niveles de agua, corrientes, etc.)
  - units (cadena, opcional) - Unidades a utilizar ("inglés" o "métrico")
  - format (cadena, opcional) - Formato de salida (json, xml)
get_station_details - Obtener información detallada sobre una estación
- Parámetros:
  - station (cadena) - ID de la estación
  - units (cadena, opcional) - Unidades a utilizar ("inglés" o "métrico")
  - format (cadena, opcional) - Formato de salida (json, xml)

Información sobre las fases lunares

get_moon_phase - Obtener información de la fase lunar para una fecha específica
- Parámetros:
  - date (cadena, opcional): Fecha para obtener la fase lunar (formato AAAA-MM-DD). El valor predeterminado es la fecha actual.
  - latitude (número, opcional) - Latitud para cálculos específicos de la ubicación
  - longitude (número, opcional) - Longitud para cálculos específicos de la ubicación
  - format (cadena, opcional) - Formato de salida (json o texto)
get_moon_phases_range : obtiene información de las fases lunares para un rango de fechas
- Parámetros:
  - start_date (cadena) - Fecha de inicio (formato AAAA-MM-DD)
  - end_date (cadena) - Fecha de finalización (formato AAAA-MM-DD)
  - latitude (número, opcional) - Latitud para cálculos específicos de la ubicación
  - longitude (número, opcional) - Longitud para cálculos específicos de la ubicación
  - format (cadena, opcional) - Formato de salida (json o texto)
get_next_moon_phase - Obtener las próximas ocurrencias de una fase lunar específica
- Parámetros:
  - phase (cadena) - Fase lunar a encontrar (Luna nueva, Cuarto creciente, Luna llena, Cuarto menguante)
  - date (cadena, opcional): Fecha de inicio (formato AAAA-MM-DD). El valor predeterminado es la fecha actual.
  - count (número, opcional): Número de ocurrencias a devolver. El valor predeterminado es 1.
  - format (cadena, opcional) - Formato de salida (json o texto)

Información sobre la salida y puesta del sol

get_sun_times : obtiene la hora de salida y puesta del sol y otros eventos solares para una fecha y ubicación específicas
- Parámetros:
  - date (cadena, opcional): Fecha para obtener la hora del sol (formato AAAA-MM-DD). El valor predeterminado es la fecha actual.
  - latitude (número) - Latitud para cálculos específicos de la ubicación
  - longitude (número) - Longitud para cálculos específicos de la ubicación
  - format (cadena, opcional) - Formato de salida (json o texto)
  - timezone (cadena, opcional): Zona horaria de los resultados. El valor predeterminado es UTC.
get_sun_times_range : obtiene las horas de salida y puesta del sol y otros eventos solares para un rango de fechas y una ubicación
- Parámetros:
  - start_date (cadena) - Fecha de inicio (formato AAAA-MM-DD)
  - end_date (cadena) - Fecha de finalización (formato AAAA-MM-DD)
  - latitude (número) - Latitud para cálculos específicos de la ubicación
  - longitude (número) - Longitud para cálculos específicos de la ubicación
  - format (cadena, opcional) - Formato de salida (json o texto)
  - timezone (cadena, opcional): Zona horaria de los resultados. El valor predeterminado es UTC.
get_sun_position : obtiene información sobre la posición del sol para una fecha, hora y ubicación específicas
- Parámetros:
  - date (cadena, opcional): Fecha para obtener la posición del sol (formato AAAA-MM-DD). El valor predeterminado es la fecha actual.
  - time (cadena, opcional): Hora para obtener la posición del sol (formato HH:MM:SS). El valor predeterminado es la hora actual.
  - latitude (número) - Latitud para cálculos específicos de la ubicación
  - longitude (número) - Longitud para cálculos específicos de la ubicación
  - format (cadena, opcional) - Formato de salida (json o texto)
get_next_sun_event - Obtener las próximas ocurrencias de un evento solar específico
- Parámetros:
  - event (cadena) - Evento solar a buscar (amanecer, atardecer, amanecer, anochecer, mediodía solar, etc.)
  - date (cadena, opcional): Fecha de inicio (formato AAAA-MM-DD). El valor predeterminado es la fecha actual.
  - latitude (número) - Latitud para cálculos específicos de la ubicación
  - longitude (número) - Longitud para cálculos específicos de la ubicación
  - count (número, opcional): Número de ocurrencias a devolver. El valor predeterminado es 1.
  - format (cadena, opcional) - Formato de salida (json o texto)
  - timezone (cadena, opcional): Zona horaria de los resultados. El valor predeterminado es UTC.

Documentación de la API

La documentación de la API de mareas y corrientes de la NOAA se puede encontrar en:

API de datos CO-OPS: https://api.tidesandcurrents.noaa.gov/api/prod/
API de metadatos de CO-OPS: https://api.tidesandcurrents.noaa.gov/mdapi/prod/
API de producto derivado de CO-OPS: https://api.tidesandcurrents.noaa.gov/dpapi/prod/

Acerca de FastMCP

FastMCP es un framework TypeScript para crear servidores MCP capaces de gestionar sesiones de cliente. Ofrece:

Herramienta sencilla, recurso, definición rápida
Sesiones
Contenido de la imagen
Explotación florestal
Manejo de errores
SSE
Notificaciones de progreso
Eventos de servidor tipificados
Y más

Obtenga más información en: https://github.com/punkpeye/fastmcp

Licencia

Instituto Tecnológico de Massachusetts (MIT)

noaa-tidesandcurrents-mcp