Skip to main content
Glama
deenesjakoruzh
vessel-api

VesselAPI MCP Server

by vessel-api
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

VesselAPI MCP Server

CI npm Node License: MIT

Сервер MCP (Model Context Protocol), который предоставляет морские данные из VesselAPI для ИИ-ассистентов, таких как Claude Desktop, Cursor, Windsurf и Claude Code.

Предварительные требования

  1. Зарегистрируйтесь на dashboard.vesselapi.com

  2. Создайте API-токен в своей панели управления

  3. Используйте токен как VESSELAPI_API_KEY в конфигурации ниже

Ресурсы: Документация | API Explorer | Панель управления | Связаться с поддержкой

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

Возможности

  • 19 инструментов, охватывающих суда, порты, поиск по местоположению и выбросы

  • Поиск судов, позиции (одиночные и пакетные), ETA, выбросы и аварии

  • Поиск портов, детали, события порта (прибытия/отправления) и глобальный поиск событий порта

  • Географический поиск судов (ограничивающая рамка и радиус)

  • Ручная пагинация для контроля использования квоты API

Размещённое развёртывание

Размещённое развёртывание доступно на Fronteir AI.

Быстрый старт

Установка не требуется. Настройте свой ИИ-клиент с помощью npx:

{
  "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

Найти суда в радиусе от точки (с опциональным диапазоном времени)

Пагинация

Все конечные точки списков поддерживают параметры limit и nextToken для ручной пагинации. Когда существует больше результатов, ответ включает 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

Источники данных и атрибуция

Данные о выбросах и авариях: © Европейский союз. Источник: Европейское агентство по безопасности на море (EMSA): THETIS-MRV (EU MRV, Регламент (ЕС) 2015/757) и Европейская платформа информации о морских авариях (EMCIP). Используется повторно в соответствии с уведомлением Европейской комиссии о повторном использовании (Решение Комиссии 2011/833/ЕС), которое разрешает повторное использование в коммерческих и некоммерческих целях с указанием источника. Данные могут быть преобразованы и объединены; EMSA не поддерживает этот сервис.

Лицензия

MIT

Install Server
A
license - permissive license
B
quality
B
maintenance

How are these scores calculated?

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.

Tools

View all tools

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