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. 서버를 빌드하세요:

npm run build

구성

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

MCP 설정 구성

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

Claude 데스크톱 앱(macOS)용

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

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude VSCode 확장 프로그램용

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

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

사용 예

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

선박 위치 가져오기

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessel_position</tool_name>
<arguments>
{
  "identifier": "123456789"
}
</arguments>
</use_mcp_tool>

선박 검색

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>search_vessels</tool_name>
<arguments>
{
  "vessel_name": "MAERSK"
}
</arguments>
</use_mcp_tool>

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

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_vessels_in_area</tool_name>
<arguments>
{
  "latitude": 37.8199,
  "longitude": -122.4783,
  "radius": 10
}
</arguments>
</use_mcp_tool>

선박 자원 접근

<access_mcp_resource>
<server_name>marinetraffic</server_name>
<uri>vessel://123456789</uri>
</access_mcp_resource>

API 키 제한 사항

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

문제 해결

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

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

API 키 제한 사항

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

문제 해결

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

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

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

특허

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