LocalTides MCP-Server

Dies ist ein MCP-Server (Model Context Protocol), der Tools für die Interaktion mit der NOAA Tides and Currents API unter Verwendung des FastMCP-Frameworks bereitstellt.

Merkmale

• Abrufen von Wasserstandsdaten (Echtzeit und historisch)

• Gezeitenvorhersagen (Hoch-/Niedrig- oder Intervall-basiert)

• Strömungsdaten (Echtzeit und historisch)

• Aktuelle Vorhersagen

• Abrufen von Sendermetadaten

• Wind, Lufttemperatur, Wassertemperatur und andere meteorologische Daten

• Informationen zu den Mondphasen (Vergangenheit, Gegenwart und Zukunft)

• Sonnenauf-/-untergangs- und Positionsdaten (Vergangenheit, Gegenwart und Zukunft)

Related MCP server: mcp-noaa-tides

Voraussetzungen

• Node.js (v18 oder höher)

• npm oder yarn

Aufstellen

Installation über Smithery

So installieren Sie NOAA Tides and Currents für Claude Desktop automatisch über Smithery :

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

Manuelle Installation

1. Dieses Repository klonen

2. Abhängigkeiten installieren

npm install

3. Erstellen Sie den TypeScript-Code

npm run build

4. Starten Sie den Server

npm start

Verwendung

Dieser MCP-Server kann mit jedem MCP-Host wie Claude Desktop verwendet werden, wodurch Sie die NOAA Tides and Currents API über das MCP-Protokoll verwenden können.

Sie können es auch direkt mit dem Befehlszeilentool fastmcp testen:

npx fastmcp dev dist/index.js

Oder Sie können den MCP Inspector verwenden:

npx fastmcp inspect dist/index.js

Verfügbare Tools

Parameterdefinitionen

• get_parameter_definitions - Informationen zu gültigen Parameterwerten für NOAA-API-Anfragen abrufen

  • Parameter:

    • parameter (Zeichenfolge, optional) – Parametertyp, über den Informationen abgerufen werden sollen (Zeitzonen, Bezugspunkte, Einheiten, Gezeitenintervalle, Strömungsintervalle, Geschwindigkeitstypen, Produkte, Stationstypen, Datumsformate, Ausgabeformate). Falls nicht angegeben, werden Informationen zu allen Parametertypen zurückgegeben.

Wasserstände

• get_water_levels - Wasserstandsdaten für eine Station abrufen

  • Parameter:

    • station (Zeichenfolge) – Stations-ID

    • date (Zeichenfolge, optional) – Datum, für das Daten abgerufen werden sollen („heute“, „neueste“, „kürzlich“ oder bestimmtes Datum)

    • begin_date (Zeichenfolge, optional) – Startdatum (JJJJMMTT oder MM/TT/JJJJ)

    • end_date (Zeichenfolge, optional) – Enddatum (JJJJMMTT oder MM/TT/JJJJ)

    • range (Zahl, optional) – Anzahl der Stunden, für die Daten abgerufen werden sollen

    • datum (Zeichenfolge, optional) – Zu verwendendes Datum (MLLW, MSL usw.)

    • units (Zeichenfolge, optional) – Zu verwendende Einheiten („englisch“ oder „metrisch“)

    • time_zone (Zeichenfolge, optional) – Zeitzone (gmt, lst, lst_ldt)

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON, XML, CSV)

Gezeitenvorhersagen

• get_tide_predictions - Gezeitenvorhersagedaten abrufen

  • Parameter:

    • station (Zeichenfolge) – Stations-ID

    • begin_date (Zeichenfolge) – Startdatum (JJJJMMTT oder MM/TT/JJJJ)

    • end_date (Zeichenfolge) – Enddatum (JJJJMMTT oder MM/TT/JJJJ)

    • datum (Zeichenfolge, optional) – Zu verwendendes Datum (MLLW, MSL usw.)

    • units (Zeichenfolge, optional) – Zu verwendende Einheiten („englisch“ oder „metrisch“)

    • time_zone (Zeichenfolge, optional) – Zeitzone (gmt, lst, lst_ldt)

    • interval (Zeichenfolge, optional) – Intervall (hilo, hl, h oder eine Zahl für Minuten)

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON, XML, CSV)

Strömungen

• get_currents - Strömungsdaten für eine Station abrufen

  • Parameter:

    • station (Zeichenfolge) – Stations-ID

    • date (Zeichenfolge, optional) – Datum, für das Daten abgerufen werden sollen („heute“, „neueste“, „kürzlich“ oder bestimmtes Datum)

    • begin_date (Zeichenfolge, optional) – Startdatum (JJJJMMTT oder MM/TT/JJJJ)

    • end_date (Zeichenfolge, optional) – Enddatum (JJJJMMTT oder MM/TT/JJJJ)

    • bin (Nummer, optional) – Behälternummer

    • units (Zeichenfolge, optional) – Zu verwendende Einheiten („englisch“ oder „metrisch“)

    • time_zone (Zeichenfolge, optional) – Zeitzone (gmt, lst, lst_ldt)

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON, XML, CSV)

Aktuelle Vorhersagen

• get_current_predictions - Aktuelle Vorhersagen abrufen

  • Parameter:

    • station (Zeichenfolge) – Stations-ID

    • date (Zeichenfolge, optional) – Datum, für das Daten abgerufen werden sollen („heute“, „neueste“, „kürzlich“ oder bestimmtes Datum)

    • begin_date (Zeichenfolge, optional) – Startdatum (JJJJMMTT oder MM/TT/JJJJ)

    • end_date (Zeichenfolge, optional) – Enddatum (JJJJMMTT oder MM/TT/JJJJ)

    • bin (Nummer, optional) – Behälternummer

    • interval (Zeichenfolge, optional) – Intervall (MAX_SLACK oder eine Zahl für Minuten)

    • vel_type (Zeichenfolge, optional) – Geschwindigkeitstyp (speed_dir oder Standard)

    • units (Zeichenfolge, optional) – Zu verwendende Einheiten („englisch“ oder „metrisch“)

    • time_zone (Zeichenfolge, optional) – Zeitzone (gmt, lst, lst_ldt)

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON, XML, CSV)

Meteorologische Daten

• get_meteorological_data - Wetterdaten abrufen

  • Parameter:

    • station (Zeichenfolge) – Stations-ID

    • product (Zeichenfolge) – Produkt (Lufttemperatur, Wind usw.)

    • date (Zeichenfolge, optional) – Datum, für das Daten abgerufen werden sollen („heute“, „neueste“, „kürzlich“ oder bestimmtes Datum)

    • begin_date (Zeichenfolge, optional) – Startdatum (JJJJMMTT oder MM/TT/JJJJ)

    • end_date (Zeichenfolge, optional) – Enddatum (JJJJMMTT oder MM/TT/JJJJ)

    • units (Zeichenfolge, optional) – Zu verwendende Einheiten („englisch“ oder „metrisch“)

    • time_zone (Zeichenfolge, optional) – Zeitzone (gmt, lst, lst_ldt)

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON, XML, CSV)

Stationsinformationen

• get_stations - Liste der Stationen abrufen

  • Parameter:

    • type (Zeichenfolge, optional) – Stationstyp (Wasserstände, Strömungen usw.)

    • units (Zeichenfolge, optional) – Zu verwendende Einheiten („englisch“ oder „metrisch“)

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON, XML)

• get_station_details - Detaillierte Informationen zu einer Station abrufen

  • Parameter:

    • station (Zeichenfolge) – Stations-ID

    • units (Zeichenfolge, optional) – Zu verwendende Einheiten („englisch“ oder „metrisch“)

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON, XML)

Informationen zur Mondphase

• get_moon_phase - Mondphaseninformationen für ein bestimmtes Datum abrufen

  • Parameter:

    • date (Zeichenfolge, optional) – Datum, für das die Mondphase ermittelt werden soll (Format JJJJ-MM-TT). Standardmäßig wird das aktuelle Datum verwendet.

    • latitude (Zahl, optional) - Breitengrad für ortsspezifische Berechnungen

    • longitude (Zahl, optional) - Längengrad für ortsspezifische Berechnungen

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON oder Text)

• get_moon_phases_range - Mondphaseninformationen für einen Datumsbereich abrufen

  • Parameter:

    • start_date (Zeichenfolge) – Startdatum (Format JJJJ-MM-TT)

    • end_date (Zeichenfolge) – Enddatum (Format JJJJ-MM-TT)

    • latitude (Zahl, optional) - Breitengrad für ortsspezifische Berechnungen

    • longitude (Zahl, optional) - Längengrad für ortsspezifische Berechnungen

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON oder Text)

• get_next_moon_phase - Ruft das/die nächste(n) Vorkommen einer bestimmten Mondphase ab

  • Parameter:

    • phase (Zeichenfolge) – Zu ermittelnde Mondphase (Neumond, erstes Viertel, Vollmond, letztes Viertel)

    • date (Zeichenfolge, optional) – Startdatum (Format JJJJ-MM-TT). Standardmäßig das aktuelle Datum.

    • count (Zahl, optional) – Anzahl der zurückzugebenden Vorkommen. Der Standardwert ist 1.

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON oder Text)

Informationen zu Sonnenaufgang und -untergang

• get_sun_times - Erhalten Sie Sonnenaufgangs-/Untergangszeiten und andere Sonnenereignisse für ein bestimmtes Datum und einen bestimmten Ort

  • Parameter:

    • date (Zeichenfolge, optional) – Datum, für das die Sonnenzeiten abgerufen werden sollen (Format JJJJ-MM-TT). Standardmäßig wird das aktuelle Datum verwendet.

    • latitude (Zahl) - Breitengrad für ortsspezifische Berechnungen

    • longitude (Zahl) - Längengrad für ortsspezifische Berechnungen

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON oder Text)

    • timezone (Zeichenfolge, optional) – Zeitzone für die Ergebnisse. Standardmäßig UTC.

• get_sun_times_range - Ermittelt Sonnenauf- und -untergangszeiten sowie andere Sonnenereignisse für einen Datumsbereich und einen Ort

  • Parameter:

    • start_date (Zeichenfolge) – Startdatum (Format JJJJ-MM-TT)

    • end_date (Zeichenfolge) – Enddatum (Format JJJJ-MM-TT)

    • latitude (Zahl) - Breitengrad für ortsspezifische Berechnungen

    • longitude (Zahl) - Längengrad für ortsspezifische Berechnungen

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON oder Text)

    • timezone (Zeichenfolge, optional) – Zeitzone für die Ergebnisse. Standardmäßig UTC.

• get_sun_position - Informationen zur Sonnenposition für ein bestimmtes Datum, eine bestimmte Uhrzeit und einen bestimmten Ort abrufen

  • Parameter:

    • date (Zeichenfolge, optional) – Datum, für das die Sonnenposition ermittelt werden soll (Format JJJJ-MM-TT). Standardmäßig wird das aktuelle Datum verwendet.

    • time (Zeichenfolge, optional) – Uhrzeit für die Sonnenposition (Format HH:MM:SS). Standardmäßig wird die aktuelle Uhrzeit verwendet.

    • latitude (Zahl) - Breitengrad für ortsspezifische Berechnungen

    • longitude (Zahl) - Längengrad für ortsspezifische Berechnungen

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON oder Text)

• get_next_sun_event - Ruft das/die nächste(n) Vorkommen eines bestimmten Sonnenereignisses ab

  • Parameter:

    • event (Zeichenfolge) – Zu suchendes Sonnenereignis (Sonnenaufgang, Sonnenuntergang, Morgengrauen, Abenddämmerung, Sonnenmittag usw.)

    • date (Zeichenfolge, optional) – Startdatum (Format JJJJ-MM-TT). Standardmäßig das aktuelle Datum.

    • latitude (Zahl) - Breitengrad für ortsspezifische Berechnungen

    • longitude (Zahl) - Längengrad für ortsspezifische Berechnungen

    • count (Zahl, optional) – Anzahl der zurückzugebenden Vorkommen. Der Standardwert ist 1.

    • format (Zeichenfolge, optional) – Ausgabeformat (JSON oder Text)

    • timezone (Zeichenfolge, optional) – Zeitzone für die Ergebnisse. Standardmäßig UTC.

API-Dokumentation

Die NOAA Tides and Currents API-Dokumentation finden Sie unter:

• CO-OPS-Daten-API: https://api.tidesandcurrents.noaa.gov/api/prod/

• CO-OPS-Metadaten-API: https://api.tidesandcurrents.noaa.gov/mdapi/prod/

• CO-OPS-API für abgeleitete Produkte: https://api.tidesandcurrents.noaa.gov/dpapi/prod/

Lizenz

MIT