LocalTides MCP Server

LocalTides MCP 서버

이는 FastMCP 프레임워크를 사용하여 NOAA 조수 및 해류 API와 상호 작용하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

특징

• 수위 데이터 검색(실시간 및 과거)
• 조수 예측(고조/저조 또는 간격 기반)
• 해류 데이터(실시간 및 과거)
• 현재 예측
• 스테이션 메타데이터 검색
• 바람, 기온, 수온 및 기타 기상 데이터
• 달의 위상 정보(과거, 현재, 미래)
• 일출/일몰 및 위치 데이터(과거, 현재, 미래)

필수 조건

• Node.js(v18 이상)
• npm 또는 yarn

설정

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 NOAA Tides and Currents를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 이 저장소를 복제하세요
2. 종속성 설치

3. TypeScript 코드 작성

4. 서버를 시작합니다

용법

이 MCP 서버는 Claude Desktop과 같은 모든 MCP 호스트와 함께 사용할 수 있으며, 이를 통해 MCP 프로토콜을 통해 NOAA 조수 및 해류 API를 사용할 수 있습니다.

fastmcp 명령줄 도구를 사용하여 직접 테스트할 수도 있습니다.

또는 MCP Inspector를 사용할 수 있습니다.

사용 가능한 도구

매개변수 정의

• get_parameter_definitions - NOAA API 요청에 대한 유효한 매개변수 값에 대한 정보를 가져옵니다.
  • 매개변수:
    • parameter (문자열, 선택 사항) - 정보를 가져올 매개변수 유형(시간대, 기준점, 단위, 조수 간격, 해류 간격, 속도 유형, 제품, 관측소 유형, 날짜 형식, 출력 형식). 매개변수를 지정하지 않으면 모든 매개변수 유형에 대한 정보를 반환합니다.

수위

• get_water_levels - 관측소의 수위 데이터 가져오기
  • 매개변수:
    • station (문자열) - 스테이션 ID
    • date (문자열, 선택 사항) - 데이터를 검색할 날짜("오늘", "최신", "최근" 또는 특정 날짜)
    • begin_date (문자열, 선택 사항) - 시작 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • end_date (문자열, 선택 사항) - 종료 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • range (숫자, 선택 사항) - 데이터를 검색할 시간 수
    • datum (문자열, 선택 사항) - 사용할 데이터(MLLW, MSL 등)
    • units (문자열, 선택 사항) - 사용할 단위("english" 또는 "metric")
    • time_zone (문자열, 선택 사항) - 표준 시간대(gmt, lst, lst_ldt)
    • format (문자열, 선택 사항) - 출력 형식(json, xml, csv)

조수 예측

• get_tide_predictions - 조수 예측 데이터 가져오기
  • 매개변수:
    • station (문자열) - 스테이션 ID
    • begin_date (문자열) - 시작 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • end_date (문자열) - 종료 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • datum (문자열, 선택 사항) - 사용할 데이터(MLLW, MSL 등)
    • units (문자열, 선택 사항) - 사용할 단위("english" 또는 "metric")
    • time_zone (문자열, 선택 사항) - 표준 시간대(gmt, lst, lst_ldt)
    • interval (문자열, 선택 사항) - 간격(hilo, hl, h 또는 분을 나타내는 숫자)
    • format (문자열, 선택 사항) - 출력 형식(json, xml, csv)

해류

• get_currents - 스테이션의 전류 데이터 가져오기
  • 매개변수:
    • station (문자열) - 스테이션 ID
    • date (문자열, 선택 사항) - 데이터를 검색할 날짜("오늘", "최신", "최근" 또는 특정 날짜)
    • begin_date (문자열, 선택 사항) - 시작 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • end_date (문자열, 선택 사항) - 종료 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • bin (숫자, 선택 사항) - Bin 번호
    • units (문자열, 선택 사항) - 사용할 단위("english" 또는 "metric")
    • time_zone (문자열, 선택 사항) - 표준 시간대(gmt, lst, lst_ldt)
    • format (문자열, 선택 사항) - 출력 형식(json, xml, csv)

현재 예측

• get_current_predictions - 현재 예측 가져오기
  • 매개변수:
    • station (문자열) - 스테이션 ID
    • date (문자열, 선택 사항) - 데이터를 검색할 날짜("오늘", "최신", "최근" 또는 특정 날짜)
    • begin_date (문자열, 선택 사항) - 시작 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • end_date (문자열, 선택 사항) - 종료 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • bin (숫자, 선택 사항) - Bin 번호
    • interval (문자열, 선택 사항) - 간격(MAX_SLACK 또는 분 단위 숫자)
    • vel_type (문자열, 선택 사항) - 속도 유형(speed_dir 또는 기본값)
    • units (문자열, 선택 사항) - 사용할 단위("english" 또는 "metric")
    • time_zone (문자열, 선택 사항) - 표준 시간대(gmt, lst, lst_ldt)
    • format (문자열, 선택 사항) - 출력 형식(json, xml, csv)

기상 데이터

• get_meteorological_data - 기상 데이터 가져오기
  • 매개변수:
    • station (문자열) - 스테이션 ID
    • product (문자열) - 제품(기온, 바람 등)
    • date (문자열, 선택 사항) - 데이터를 검색할 날짜("오늘", "최신", "최근" 또는 특정 날짜)
    • begin_date (문자열, 선택 사항) - 시작 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • end_date (문자열, 선택 사항) - 종료 날짜(YYYYMMDD 또는 MM/DD/YYYY)
    • units (문자열, 선택 사항) - 사용할 단위("english" 또는 "metric")
    • time_zone (문자열, 선택 사항) - 표준 시간대(gmt, lst, lst_ldt)
    • format (문자열, 선택 사항) - 출력 형식(json, xml, csv)

역 정보

• get_stations - 방송국 목록 가져오기
  • 매개변수:
    • type (문자열, 선택 사항) - 관측소 유형(수위, 해류 등)
    • units (문자열, 선택 사항) - 사용할 단위("english" 또는 "metric")
    • format (문자열, 선택 사항) - 출력 형식(json, xml)
• get_station_details - 역에 대한 자세한 정보를 가져옵니다.
  • 매개변수:
    • station (문자열) - 스테이션 ID
    • units (문자열, 선택 사항) - 사용할 단위("english" 또는 "metric")
    • format (문자열, 선택 사항) - 출력 형식(json, xml)

달의 위상 정보

• get_moon_phase - 특정 날짜의 달의 위상 정보를 가져옵니다.
  • 매개변수:
    • date (문자열, 선택 사항) - 달의 위상을 가져올 날짜(YYYY-MM-DD 형식). 기본값은 현재 날짜입니다.
    • latitude (숫자, 선택 사항) - 위치별 계산을 위한 위도
    • longitude (숫자, 선택 사항) - 위치별 계산을 위한 경도
    • format (문자열, 선택 사항) - 출력 형식(json 또는 텍스트)
• get_moon_phases_range - 날짜 범위에 대한 달의 위상 정보를 가져옵니다.
  • 매개변수:
    • start_date (문자열) - 시작 날짜(YYYY-MM-DD 형식)
    • end_date (문자열) - 종료 날짜(YYYY-MM-DD 형식)
    • latitude (숫자, 선택 사항) - 위치별 계산을 위한 위도
    • longitude (숫자, 선택 사항) - 위치별 계산을 위한 경도
    • format (문자열, 선택 사항) - 출력 형식(json 또는 텍스트)
• get_next_moon_phase - 특정 달의 다음 위상을 가져옵니다.
  • 매개변수:
    • phase (문자열) - 찾을 달의 위상 (초승달, 상현달, 보름달, 하현달)
    • date (문자열, 선택 사항) - 시작 날짜(YYYY-MM-DD 형식). 기본값은 현재 날짜입니다.
    • count (숫자, 선택 사항) - 반환할 발생 횟수입니다. 기본값은 1입니다.
    • format (문자열, 선택 사항) - 출력 형식(json 또는 텍스트)

일출/일몰 정보

• get_sun_times - 특정 날짜 및 위치의 일출/일몰 및 기타 태양 이벤트 시간을 가져옵니다.
  • 매개변수:
    • date (문자열, 선택 사항) - 일조 시간을 가져올 날짜(YYYY-MM-DD 형식). 기본값은 현재 날짜입니다.
    • latitude (숫자) - 위치별 계산을 위한 위도
    • longitude (숫자) - 위치별 계산을 위한 경도
    • format (문자열, 선택 사항) - 출력 형식(json 또는 텍스트)
    • timezone (문자열, 선택 사항) - 결과의 시간대입니다. 기본값은 UTC입니다.
• get_sun_times_range - 날짜 범위 및 위치에 대한 일출/일몰 및 기타 태양 현상 시간을 가져옵니다.
  • 매개변수:
    • start_date (문자열) - 시작 날짜(YYYY-MM-DD 형식)
    • end_date (문자열) - 종료 날짜(YYYY-MM-DD 형식)
    • latitude (숫자) - 위치별 계산을 위한 위도
    • longitude (숫자) - 위치별 계산을 위한 경도
    • format (문자열, 선택 사항) - 출력 형식(json 또는 텍스트)
    • timezone (문자열, 선택 사항) - 결과의 시간대입니다. 기본값은 UTC입니다.
• get_sun_position - 특정 날짜, 시간 및 위치에 대한 태양 위치 정보를 가져옵니다.
  • 매개변수:
    • date (문자열, 선택 사항) - 태양 위치를 가져올 날짜(YYYY-MM-DD 형식). 기본값은 현재 날짜입니다.
    • time (문자열, 선택 사항) - 태양 위치를 가져올 시간(HH:MM:SS 형식). 기본값은 현재 시간입니다.
    • latitude (숫자) - 위치별 계산을 위한 위도
    • longitude (숫자) - 위치별 계산을 위한 경도
    • format (문자열, 선택 사항) - 출력 형식(json 또는 텍스트)
• get_next_sun_event - 특정 태양 이벤트의 다음 발생을 가져옵니다.
  • 매개변수:
    • event (문자열) - 찾을 태양 이벤트 (일출, 일몰, 새벽, 황혼, 태양정오 등)
    • date (문자열, 선택 사항) - 시작 날짜(YYYY-MM-DD 형식). 기본값은 현재 날짜입니다.
    • latitude (숫자) - 위치별 계산을 위한 위도
    • longitude (숫자) - 위치별 계산을 위한 경도
    • count (숫자, 선택 사항) - 반환할 발생 횟수입니다. 기본값은 1입니다.
    • format (문자열, 선택 사항) - 출력 형식(json 또는 텍스트)
    • timezone (문자열, 선택 사항) - 결과의 시간대입니다. 기본값은 UTC입니다.

API 문서

NOAA 조수 및 해류 API 문서는 다음에서 찾을 수 있습니다.

• CO-OPS 데이터 API: https://api.tidesandcurrents.noaa.gov/api/prod/
• CO-OPS 메타데이터 API: https://api.tidesandcurrents.noaa.gov/mdapi/prod/
• CO-OPS 파생 제품 API: https://api.tidesandcurrents.noaa.gov/dpapi/prod/

특허

MIT