LocalTides MCP Server

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)

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 :

Manuelle Installation

1. Dieses Repository klonen
2. Abhängigkeiten installieren

3. Erstellen Sie den TypeScript-Code

4. Starten Sie den Server

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:

Oder Sie können den MCP Inspector verwenden:

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 die Zeiten für Sonnenaufgang/-untergang und 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