Skip to main content
Glama
vessel-api

VesselAPI MCP Server

by vessel-api

VesselAPI MCP Server

CI npm Node License: MIT

Un servidor de MCP (Model Context Protocol) que expone datos marítimos de VesselAPI a asistentes de IA como Claude Desktop, Cursor, Windsurf y Claude Code.

Requisitos previos

  1. Regístrate en dashboard.vesselapi.com

  2. Crea un token de API en tu panel de control

  3. Usa el token como VESSELAPI_API_KEY en la configuración siguiente

Recursos: Documentación | Explorador de API | Panel de control | Contactar con soporte

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

Características

  • 19 herramientas que cubren buques, puertos, búsqueda de ubicaciones y emisiones

  • Búsqueda de buques, posiciones (individual y por lotes), ETA, emisiones y siniestros

  • Búsqueda de puertos, detalles, eventos portuarios (llegadas/salidas) y búsqueda global de eventos portuarios

  • Búsqueda geográfica de buques (cuadro delimitador y radio)

  • Paginación manual para controlar el uso de la cuota de API

Implementación alojada

Hay una implementación alojada disponible en Fronteir AI.

Inicio rápido

No se requiere instalación. Configura tu cliente de IA con npx:

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

Configuración

Añade el JSON anterior al archivo de configuración de tu cliente:

Cliente

Archivo de configuración

Claude Desktop

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

Cursor

.cursor/mcp.json o ~/.cursor/mcp.json

Claude Code

claude mcp add, que escribe .mcp.json en el proyecto o ~/.claude.json para el ámbito de usuario

Windsurf

~/.codeium/windsurf/mcp_config.json

Herramientas

Herramientas de buques

Herramienta

Descripción

search_vessels

Busca buques por nombre, IMO, MMSI, pabellón, tipo, indicativo o año de construcción

get_vessel

Obtén información detallada del buque

get_vessel_position

Obtén la posición actual del buque (lat/lon, velocidad, rumbo)

get_vessel_eta

Obtén la hora estimada de llegada del buque

get_vessel_emissions

Obtén datos de emisiones (CO2, consumo de combustible)

get_vessel_casualties

Obtén registros de siniestros marítimos

get_vessel_positions_batch

Obtén posiciones de varios buques a la vez (con rango de tiempo opcional)

Herramientas de puertos

Herramienta

Descripción

search_ports

Busca puertos por nombre, país, tipo, tamaño, región, tamaño de dársena o uso de dársena

get_port

Obtén detalles del puerto por UN/LOCODE

get_port_inbound

Obtén buques con destino a un puerto dentro de una ventana de ETA

get_port_events

Obtén llegadas/salidas de un puerto

get_port_events_by_vessel

Obtén eventos portuarios de un buque

list_port_events

Enumera eventos portuarios a nivel mundial con filtros por tiempo, país, puerto, buque o tipo de evento

search_port_events_by_port

Busca eventos portuarios por nombre de puerto

search_port_events_by_vessel

Busca eventos portuarios por nombre de buque

get_vessel_last_port_event

Obtén el evento portuario más reciente de un buque

Herramientas de emisiones

Herramienta

Descripción

list_emissions

Enumera datos globales de emisiones de buques con filtro de año opcional

Herramientas de ubicación

Herramienta

Descripción

get_vessels_in_area

Encuentra buques en un cuadro delimitador (con rango de tiempo opcional)

get_vessels_in_radius

Encuentra buques dentro de un radio desde un punto (con rango de tiempo opcional)

Paginación

Todos los endpoints de listado admiten los parámetros limit y nextToken para la paginación manual. Cuando existen más resultados, la respuesta incluye un nextToken. Pásalo en la siguiente llamada para obtener la siguiente página.

Desarrollo

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

Pruebas con MCP Inspector

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

Fuentes de datos y atribución

Los datos de emisiones y siniestros: © Unión Europea. Fuente: Agencia Europea de Seguridad Marítima (EMSA): THETIS-MRV (EU MRV, Reglamento (UE) 2015/757) y la Plataforma Europea de Información sobre Siniestros Marítimos (EMCIP). Reutilizado conforme al aviso de reutilización de la Comisión Europea (Decisión 2011/833/UE), que autoriza la reutilización con fines comerciales y no comerciales con reconocimiento de la fuente. Los datos pueden ser transformados y combinados; EMSA no respalda este servicio.

Licencia

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