noaa-tidesandcurrents-mcp

LocalTides MCP-сервер

Это сервер MCP (Model Context Protocol), который предоставляет инструменты для взаимодействия с API приливов и течений NOAA с использованием фреймворка FastMCP.

Функции

• Получение данных об уровне воды (в реальном времени и исторических)
• Прогнозы приливов и отливов (высокие/низкие или на основе интервалов)
• Данные о течениях (в реальном времени и исторические)
• Текущие прогнозы
• Извлечение метаданных станции
• Ветер, температура воздуха, температура воды и другие метеорологические данные
• Информация о фазах Луны (прошлое, настоящее и будущее)
• Данные о восходе/заходе и местоположении солнца (прошлое, настоящее и будущее)

Предпосылки

• Node.js (v18 или выше)
• npm или пряжа

Настраивать

Установка через Smithery

Чтобы автоматически установить NOAA Tides and Currents для Claude Desktop через Smithery :

Ручная установка

1. Клонировать этот репозиторий
2. Установить зависимости

3. Создайте код TypeScript

4. Запустить сервер

Использование

Этот сервер MCP можно использовать с любым хостом MCP, например Claude Desktop, который позволяет использовать API приливов и течений NOAA через протокол MCP.

Вы также можете протестировать его напрямую, используя инструмент командной строки fastmcp :

Или вы можете использовать MCP Inspector:

Доступные инструменты

Определения параметров

• get_parameter_definitions — получение информации о допустимых значениях параметров для запросов API NOAA
  • Параметры:
    • parameter (строка, необязательно) — тип параметра, о котором нужно получить информацию (часовой пояс, система отсчета, единицы измерения, интервалы приливов, текущие интервалы, типы скоростей, продукты, типы станций, форматы дат, форматы выходных данных). Если не указано, возвращает информацию обо всех типах параметров.

Уровни воды

• get_water_levels — Получить данные об уровне воды на станции
  • Параметры:
    • station (строка) - идентификатор станции
    • date (строка, необязательно) — дата, за которую необходимо получить данные («сегодня», «последняя», «недавняя» или конкретная дата)
    • begin_date (строка, необязательно) — дата начала (ГГГГММДД или ММ/ДД/ГГГГ)
    • end_date (строка, необязательно) — дата окончания (ГГГГММДД или ММ/ДД/ГГГГ)
    • range (число, необязательно) — количество часов, за которые необходимо получить данные
    • datum (строка, необязательно) — используемый Datum (MLLW, MSL и т. д.)
    • units (строка, необязательно) - используемые единицы («английские» или «метрические»)
    • time_zone (строка, необязательно) - Часовой пояс (gmt, lst, lst_ldt)
    • format (строка, необязательно) - Формат вывода (json, xml, csv)

Прогнозы приливов и отливов

• get_tide_predictions — Получить данные прогноза приливов
  • Параметры:
    • station (строка) - идентификатор станции
    • begin_date (строка) — дата начала (ГГГГММДД или ММ/ДД/ГГГГ)
    • end_date (строка) — дата окончания (ГГГГММДД или ММ/ДД/ГГГГ)
    • datum (строка, необязательно) — используемый Datum (MLLW, MSL и т. д.)
    • units (строка, необязательно) - используемые единицы («английские» или «метрические»)
    • time_zone (строка, необязательно) - Часовой пояс (gmt, lst, lst_ldt)
    • interval (строка, необязательно) - Интервал (hilo, hl, h или число минут)
    • format (строка, необязательно) - Формат вывода (json, xml, csv)

Течения

• get_currents — Получить данные о течениях для станции
  • Параметры:
    • station (строка) - идентификатор станции
    • date (строка, необязательно) — дата, за которую необходимо получить данные («сегодня», «последняя», «недавняя» или конкретная дата)
    • begin_date (строка, необязательно) — дата начала (ГГГГММДД или ММ/ДД/ГГГГ)
    • end_date (строка, необязательно) — дата окончания (ГГГГММДД или ММ/ДД/ГГГГ)
    • bin (номер, необязательно) - Номер ячейки
    • units (строка, необязательно) - используемые единицы («английские» или «метрические»)
    • time_zone (строка, необязательно) - Часовой пояс (gmt, lst, lst_ldt)
    • format (строка, необязательно) - Формат вывода (json, xml, csv)

Текущие прогнозы

• get_current_predictions — Получить текущие прогнозы
  • Параметры:
    • station (строка) - идентификатор станции
    • date (строка, необязательно) — дата, за которую необходимо получить данные («сегодня», «последняя», «недавняя» или конкретная дата)
    • begin_date (строка, необязательно) — дата начала (ГГГГММДД или ММ/ДД/ГГГГ)
    • end_date (строка, необязательно) — дата окончания (ГГГГММДД или ММ/ДД/ГГГГ)
    • bin (номер, необязательно) - Номер ячейки
    • interval (строка, необязательно) - Интервал (MAX_SLACK или число минут)
    • vel_type (строка, необязательно) — тип скорости (speed_dir или по умолчанию)
    • units (строка, необязательно) - используемые единицы («английские» или «метрические»)
    • time_zone (строка, необязательно) - Часовой пояс (gmt, lst, lst_ldt)
    • format (строка, необязательно) - Формат вывода (json, xml, csv)

Метеорологические данные

• get_meteorological_data - Получить метеорологические данные
  • Параметры:
    • station (строка) - идентификатор станции
    • product (строка) - Продукт (температура_воздуха, ветер и т. д.)
    • date (строка, необязательно) — дата, за которую необходимо получить данные («сегодня», «последняя», «недавняя» или конкретная дата)
    • begin_date (строка, необязательно) — дата начала (ГГГГММДД или ММ/ДД/ГГГГ)
    • end_date (строка, необязательно) — дата окончания (ГГГГММДД или ММ/ДД/ГГГГ)
    • units (строка, необязательно) - используемые единицы («английские» или «метрические»)
    • time_zone (строка, необязательно) - Часовой пояс (gmt, lst, lst_ldt)
    • format (строка, необязательно) - Формат вывода (json, xml, csv)

Информация о станции

• get_stations - Получить список станций
  • Параметры:
    • type (строка, необязательно) - Тип станции (уровни воды, течения и т. д.)
    • units (строка, необязательно) - используемые единицы («английские» или «метрические»)
    • format (строка, необязательно) - Формат вывода (json, xml)
• get_station_details - Получить подробную информацию о станции
  • Параметры:
    • station (строка) - идентификатор станции
    • units (строка, необязательно) - используемые единицы («английские» или «метрические»)
    • format (строка, необязательно) - Формат вывода (json, xml)

Информация о фазах Луны

• get_moon_phase — Получить информацию о фазе Луны на определенную дату
  • Параметры:
    • date (строка, необязательно) — дата, для которой необходимо получить фазу Луны (формат ГГГГ-ММ-ДД). По умолчанию — текущая дата.
    • latitude (число, необязательно) — широта для расчетов, привязанных к местоположению
    • longitude (число, необязательно) — долгота для расчетов, привязанных к местоположению.
    • format (строка, необязательно) - Формат вывода (json или текст)
• get_moon_phases_range — Получить информацию о фазах Луны для диапазона дат
  • Параметры:
    • start_date (строка) - Дата начала (формат ГГГГ-ММ-ДД)
    • end_date (строка) — дата окончания (формат ГГГГ-ММ-ДД)
    • latitude (число, необязательно) — широта для расчетов, привязанных к местоположению
    • longitude (число, необязательно) — долгота для расчетов, привязанных к местоположению.
    • format (строка, необязательно) - Формат вывода (json или текст)
• get_next_moon_phase — Получить следующее(ие) наступление(я) определенной фазы Луны
  • Параметры:
    • phase (строка) - фаза Луны, которую нужно найти (Новолуние, Первая четверть, Полнолуние, Последняя четверть)
    • date (строка, необязательно) — начальная дата (формат ГГГГ-ММ-ДД). По умолчанию — текущая дата.
    • count (число, необязательно) — количество возвращаемых вхождений. По умолчанию 1.
    • format (строка, необязательно) - Формат вывода (json или текст)

Информация о восходе/заходе солнца

• get_sun_times — получить время восхода/захода солнца и других солнечных событий для определенной даты и местоположения
  • Параметры:
    • date (строка, необязательно) — дата, для которой необходимо получить время захода солнца (формат ГГГГ-ММ-ДД). По умолчанию — текущая дата.
    • latitude (число) — широта для расчетов, привязанных к местоположению
    • longitude (число) — долгота для расчетов, привязанных к местоположению.
    • format (строка, необязательно) - Формат вывода (json или текст)
    • timezone (строка, необязательно) — часовой пояс для результатов. По умолчанию UTC.
• get_sun_times_range — получить время восхода/захода солнца и других солнечных событий для определенного диапазона дат и местоположения
  • Параметры:
    • start_date (строка) - Дата начала (формат ГГГГ-ММ-ДД)
    • end_date (строка) — дата окончания (формат ГГГГ-ММ-ДД)
    • latitude (число) — широта для расчетов, привязанных к местоположению
    • longitude (число) — долгота для расчетов, привязанных к местоположению.
    • format (строка, необязательно) - Формат вывода (json или текст)
    • timezone (строка, необязательно) — часовой пояс для результатов. По умолчанию UTC.
• get_sun_position — получить информацию о положении солнца для определенной даты, времени и местоположения
  • Параметры:
    • date (строка, необязательно) — дата, для которой необходимо получить положение солнца (формат ГГГГ-ММ-ДД). По умолчанию — текущая дата.
    • time (строка, необязательно) — время для определения положения солнца (формат ЧЧ:ММ:СС). По умолчанию — текущее время.
    • latitude (число) — широта для расчетов, привязанных к местоположению
    • longitude (число) — долгота для расчетов, привязанных к местоположению.
    • format (строка, необязательно) - Формат вывода (json или текст)
• get_next_sun_event — Получить следующее(ие) возникновение(я) определенного солнечного события
  • Параметры:
    • event (строка) - событие Солнца, которое нужно найти (восход, закат, рассвет, сумерки, солнечныйПолдень и т. д.)
    • date (строка, необязательно) — начальная дата (формат ГГГГ-ММ-ДД). По умолчанию — текущая дата.
    • latitude (число) — широта для расчетов, привязанных к местоположению
    • longitude (число) — долгота для расчетов, привязанных к местоположению.
    • count (число, необязательно) — количество возвращаемых вхождений. По умолчанию 1.
    • format (строка, необязательно) - Формат вывода (json или текст)
    • timezone (строка, необязательно) — часовой пояс для результатов. По умолчанию UTC.

API-документация

Документацию API приливов и течений NOAA можно найти по адресу:

• API данных CO-OPS: https://api.tidesandcurrents.noaa.gov/api/prod/
• API метаданных CO-OPS: https://api.tidesandcurrents.noaa.gov/mdapi/prod/
• API производного продукта CO-OPS: https://api.tidesandcurrents.noaa.gov/dpapi/prod/

Лицензия

Массачусетский технологический институт