MarineTraffic MCP 서버

MarineTraffic 선박 추적 데이터에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

이 MCP 서버는 다음과 같은 기능을 제공합니다.

도구

• get_vessel_position : MMSI 또는 IMO 번호로 선박의 실시간 위치를 가져옵니다.

• get_vessel_details : MMSI 또는 IMO 번호로 선박에 대한 자세한 정보를 가져옵니다.

• search_vessels : 이름, MMSI, IMO 또는 선박 유형으로 선박 검색

• get_vessels_in_area : 지정된 지리적 영역에 있는 선박을 가져옵니다.

자원

• vessels://{identifier} : MMSI 또는 IMO 번호로 선박에 대한 정보

• vessels://area/{lat}/{lon}/{radius} : 지정된 지리적 영역에 있는 선박 목록

Related MCP server: Satellite Tracking MCP Server

설치

필수 조건

• Node.js 18 이상

• MarineTraffic API 키( MarineTraffic API 서비스 에서 사용 가능)

설정

1. 이 저장소를 복제하거나 소스 코드를 다운로드하세요

2. 종속성 설치:

지엑스피1

3. 서버를 빌드하세요:

구성

서버가 작동하려면 MarineTraffic API 키가 필요합니다. 환경 변수 MARINETRAFFIC_API_KEY 를 통해 이 키를 제공할 수 있습니다.

MCP 설정 구성

Claude와 함께 이 서버를 사용하려면 MCP 설정 구성 파일에 추가하세요.

Claude 데스크톱 앱(macOS)용

~/Library/Application Support/Claude/claude_desktop_config.json 편집합니다.

Claude VSCode 확장 프로그램용

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 편집합니다.

사용 예

서버가 구성되고 실행되면 Claude와 함께 사용하여 선박 추적 데이터에 액세스할 수 있습니다.

선박 위치 가져오기

선박 검색

해당 지역에 선박을 배치하세요

선박 자원 접근

API 키 제한 사항

MarineTraffic API는 구독 플랜에 따라 사용 제한이 있습니다. 서버 사용 시 할당량 초과를 방지하기 위해 이러한 제한 사항을 숙지하시기 바랍니다.

문제 해결

• API 키 오류 : MarineTraffic API 키가 유효하고 환경 변수에 올바르게 설정되어 있는지 확인하세요.

• 속도 제한 : 속도 제한 오류가 발생하면 서버는 지수 백오프 방식으로 자동으로 재시도하지만, 추가 요청을 하기 전에 기다려야 할 수도 있습니다. API를 통해 제공되는 자세한 선박 정보의 예

API 키 제한 사항

MarineTraffic API는 구독 플랜에 따라 사용 제한이 있습니다. 서버 사용 시 할당량 초과를 방지하기 위해 이러한 제한 사항을 숙지하시기 바랍니다.

문제 해결

• API 키 오류 : MarineTraffic API 키가 유효하고 환경 변수에 올바르게 설정되어 있는지 확인하세요.

• 속도 제한 : 속도 제한 오류가 발생하면 서버는 지수적 백오프로 자동으로 재시도하지만 추가 요청을 하기 전에 기다려야 할 수도 있습니다.

• 데이터 없음 : 일부 선박은 실시간 추적 데이터를 이용할 수 없을 수 있으며, 특히 소형 선박이나 AIS 적용 범위가 제한적인 지역에 있는 선박의 경우 더욱 그렇습니다.

특허

이 프로젝트는 ISC 라이선스에 따라 라이선스가 부여되었습니다.