remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
The server supports retrieving data from NOAA API in XML format, as specified in various tool parameters
NOAA 조수 및 해류 MCP 서버
이는 FastMCP 프레임워크를 사용하여 NOAA 조수 및 해류 API와 상호 작용하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.
특징
- 수위 데이터 검색(실시간 및 과거)
- 조수 예측(고조/저조 또는 간격 기반)
- 해류 데이터(실시간 및 과거)
- 현재 예측
- 스테이션 메타데이터 검색
- 바람, 기온, 수온 및 기타 기상 데이터
- 달의 위상 정보(과거, 현재, 미래)
- 일출/일몰 및 위치 데이터(과거, 현재, 미래)
필수 조건
- Node.js(v18 이상)
- npm 또는 yarn
설정
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 NOAA Tides and Currents를 자동으로 설치하려면:
지엑스피1
수동 설치
- 이 저장소를 복제하세요
- 종속성 설치
Copy
.env.example파일을 기반으로.env파일을 만듭니다.
Copy
- TypeScript 코드 작성
Copy
- 서버를 시작합니다
Copy
용법
이 MCP 서버는 Claude Desktop과 같은 모든 MCP 호스트와 함께 사용할 수 있으며, 이를 통해 MCP 프로토콜을 통해 NOAA 조수 및 해류 API를 사용할 수 있습니다.
fastmcp 명령줄 도구를 사용하여 직접 테스트할 수도 있습니다.
Copy
또는 MCP Inspector를 사용할 수 있습니다.
Copy
사용 가능한 도구
수위
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
You must be authenticated.
Tools
이는 NOAA 조수 및 해류 API와 상호 작용하기 위한 도구를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.