Skip to main content
Glama
vessel-api

VesselAPI MCP Server

by vessel-api

VesselAPI MCP 서버

CI npm Node License: MIT

VesselAPI의 해양 데이터를 Claude Desktop, Cursor, Windsurf, Claude Code와 같은 AI 어시스턴트에 제공하는 MCP(Model Context Protocol) 서버입니다.

사전 요구 사항

  1. dashboard.vesselapi.com에서 가입하세요

  2. 대시보드에서 API 토큰을 생성하세요

  3. 아래 구성에서 토큰을 VESSELAPI_API_KEY로 사용하세요

리소스: 문서 | API 탐색기 | 대시보드 | 지원팀 문의

Related MCP server: @globalfishingwatch/gfw-mcp-js

기능

  • 선박, 항구, 위치 검색 및 배출량을 다루는 19개 도구

  • 선박 검색, 위치(단일 및 일괄), ETA, 배출량 및 해양 사고

  • 항구 검색, 상세 정보, 항구 이벤트(입항/출항) 및 글로벌 항구 이벤트 검색

  • 지리적 선박 검색(경계 상자 및 반경)

  • API 할당량 사용량을 제어하기 위한 수동 페이지네이션

호스팅 배포

호스팅 배포는 Fronteir AI에서 이용할 수 있습니다.

빠른 시작

설치가 필요 없습니다. npx로 AI 클라이언트를 구성하세요:

{
  "mcpServers": {
    "vesselapi": {
      "command": "npx",
      "args": ["-y", "vesselapi-mcp"],
      "env": {
        "VESSELAPI_API_KEY": "your-api-key"
      }
    }
  }
}

구성

위의 JSON을 클라이언트의 구성 파일에 추가하세요:

클라이언트

구성 파일

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)

Cursor

.cursor/mcp.json 또는 ~/.cursor/mcp.json

Claude Code

claude mcp add(프로젝트에 .mcp.json을 쓰거나 사용자 범위로 ~/.claude.json에 기록)

Windsurf

~/.codeium/windsurf/mcp_config.json

도구

선박 도구

도구

설명

search_vessels

이름, IMO, MMSI, 국적, 유형, 호출부호 또는 건조 연도로 선박 검색

get_vessel

선박 상세 정보 가져오기

get_vessel_position

현재 선박 위치(위도/경도, 속도, 방향) 가져오기

get_vessel_eta

선박 예상 도착 시간 가져오기

get_vessel_emissions

배출량 데이터(CO2, 연료 소비량) 가져오기

get_vessel_casualties

해양 사고 기록 가져오기

get_vessel_positions_batch

여러 선박의 위치를 한 번에 가져오기(선택적 시간 범위 포함)

항구 도구

도구

설명

search_ports

이름, 국가, 유형, 규모, 지역, 항만 규모 또는 항만 용도로 항구 검색

get_port

UN/LOCODE로 항구 상세 정보 가져오기

get_port_inbound

ETA 창 내에서 항구로 입항하는 선박 가져오기

get_port_events

항구의 입항/출항 이벤트 가져오기

get_port_events_by_vessel

선박의 항구 이벤트 가져오기

list_port_events

시간, 국가, 항구, 선박 또는 이벤트 유형 필터로 글로벌 항구 이벤트 나열

search_port_events_by_port

항구 이름으로 항구 이벤트 검색

search_port_events_by_vessel

선박 이름으로 항구 이벤트 검색

get_vessel_last_port_event

선박의 가장 최근 항구 이벤트 가져오기

배출량 도구

도구

설명

list_emissions

선택적 연도 필터로 글로벌 선박 배출량 데이터 나열

위치 도구

도구

설명

get_vessels_in_area

경계 상자 내 선박 찾기(선택적 시간 범위 포함)

get_vessels_in_radius

지점 반경 내 선박 찾기(선택적 시간 범위 포함)

페이지네이션

모든 목록 엔드포인트는 수동 페이지네이션을 위해 limitnextToken 매개변수를 지원합니다. 더 많은 결과가 존재하면 응답에 nextToken이 포함됩니다. 다음 호출에 이를 전달하여 다음 페이지를 가져오세요.

개발

git clone https://github.com/vessel-api/vesselapi-mcp.git
cd vesselapi-mcp
npm install
npm run build
npm run build        # Build the server
npm run typecheck    # Type-check without emitting
npm run clean        # Remove build artifacts

MCP Inspector로 테스트

VESSELAPI_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

데이터 출처 및 귀속

배출량 및 사고 데이터: © European Union. 출처: European Maritime Safety Agency (EMSA): THETIS-MRV(EU MRV, Regulation (EU) 2015/757) 및 European Marine Casualty Information Platform(EMCIP). European Commission 재사용 고지(Commission Decision 2011/833/EU)에 따라 재사용되며, 이는 출처를 명시하는 조건으로 상업적 및 비상업적 목적의 재사용을 허가합니다. 데이터는 변환 및 결합될 수 있으며, EMSA는 이 서비스를 보증하지 않습니다.

라이선스

MIT

Install Server
A
license - permissive license
B
quality
B
maintenance

Maintenance

Maintainers
Response time
4wRelease cycle
7Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vessel-api/vesselapi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server