NOAA 조수 및 해류 MCP 서버
이는 FastMCP 프레임워크를 사용하여 NOAA 조수 및 해류 API와 상호 작용하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.
특징
수위 데이터 검색(실시간 및 과거)
조수 예측(고조/저조 또는 간격 기반)
해류 데이터(실시간 및 과거)
현재 예측
스테이션 메타데이터 검색
바람, 기온, 수온 및 기타 기상 데이터
달의 위상 정보(과거, 현재, 미래)
일출/일몰 및 위치 데이터(과거, 현재, 미래)
Related MCP server: Node.js MCP Weather Server
필수 조건
Node.js(v18 이상)
npm 또는 yarn
설정
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 NOAA Tides and Currents를 자동으로 설치하려면:
지엑스피1
수동 설치
이 저장소를 복제하세요
종속성 설치
.env.example파일을 기반으로.env파일을 만듭니다.
TypeScript 코드 작성
서버를 시작합니다
용법
이 MCP 서버는 Claude Desktop과 같은 모든 MCP 호스트와 함께 사용할 수 있으며, 이를 통해 MCP 프로토콜을 통해 NOAA 조수 및 해류 API를 사용할 수 있습니다.
fastmcp 명령줄 도구를 사용하여 직접 테스트할 수도 있습니다.
또는 MCP Inspector를 사용할 수 있습니다.
사용 가능한 도구
수위
get_water_levels- 관측소의 수위 데이터 가져오기매개변수:
station(문자열) - 스테이션 IDdate(문자열, 선택 사항) - 데이터를 검색할 날짜("오늘", "최신", "최근" 또는 특정 날짜)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(문자열) - 스테이션 IDbegin_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(문자열) - 스테이션 IDdate(문자열, 선택 사항) - 데이터를 검색할 날짜("오늘", "최신", "최근" 또는 특정 날짜)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(문자열) - 스테이션 IDdate(문자열, 선택 사항) - 데이터를 검색할 날짜("오늘", "최신", "최근" 또는 특정 날짜)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(문자열) - 스테이션 IDproduct(문자열) - 제품(기온, 바람 등)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(문자열) - 스테이션 IDunits(문자열, 선택 사항) - 사용할 단위("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/
FastMCP 소개
FastMCP는 클라이언트 세션을 처리할 수 있는 MCP 서버를 구축하기 위한 TypeScript 프레임워크입니다. 다음과 같은 기능을 제공합니다.
간단한 도구, 리소스, 신속한 정의
세션
이미지 콘텐츠
벌채 반출
오류 처리
남남동
진행 상황 알림
입력된 서버 이벤트
그리고 더 많은 것
자세한 내용은 https://github.com/punkpeye/fastmcp 에서 확인하세요.
특허
MIT