MarineTraffic MCP Server

Proporciona acceso a los datos de seguimiento de embarcaciones de MarineTraffic.

Documentación

Servidor MCP de MarineTraffic

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a los datos de seguimiento de embarcaciones de MarineTraffic.

Características

Este servidor MCP proporciona las siguientes capacidades:

Herramientas

get_vessel_position: Obtener la posición en tiempo real de una embarcación por número MMSI o IMO
get_vessel_details: Obtener información detallada sobre una embarcación por número MMSI o IMO
search_vessels: Buscar embarcaciones por nombre, MMSI, IMO o tipo de embarcación
get_vessels_in_area: Obtener embarcaciones en un área geográfica especificada
get_port_calls: Obtener el historial de llamadas portuarias de llegada/salida de una embarcación por número MMSI o IMO (datos disponibles para fechas posteriores al 16-01-2015)
get_voyage_forecast: Obtener el pronóstico de viaje mediante aprendizaje automático para una embarcación por número MMSI o IMO — próximo puerto y hora estimada de llegada (ETA) previstos, combinando la posición AIS en vivo con el historial de rutas

Recursos

vessel://{identificador}: Información sobre una embarcación por número MMSI o IMO
vessels://area/{lat}/{lon}/{radio}: Lista de embarcaciones en un área geográfica especificada
port://{id_puerto}: Llamadas portuarias recientes de llegada/salida para un puerto, por ID de puerto de MarineTraffic o UN/LOCODE

Instalación

Instalación mediante Smithery

Para instalar el Servidor de Seguimiento de Embarcaciones de MarineTraffic para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @Cyreslab-AI/marinetraffic-mcp-server --client claude

Requisitos previos

Node.js 18 o superior
Una clave de API de MarineTraffic (disponible en Servicios de API de MarineTraffic)

Configuración

Clona este repositorio o descarga el código fuente
Instala las dependencias:

cd marinetraffic-server
npm install

Compila el servidor:

npm run build

Configuración

El servidor requiere una clave de API de MarineTraffic para funcionar. Puedes proporcionarla a través de la variable de entorno MARINETRAFFIC_API_KEY.

Configuración de Ajustes de MCP

Para usar este servidor con Claude, agrégalo a tu archivo de configuración de ajustes de MCP:

Para la Aplicación de Escritorio de Claude (macOS)

Edita ~/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": []
    }
  }
}

Para la Extensión de Claude VSCode

Edita ~/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": []
    }
  }
}

Ejemplos de Uso

Una vez que el servidor esté configurado y en ejecución, puedes usarlo con Claude para acceder a los datos de seguimiento de embarcaciones:

Obtener Posición de Embarcación

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

Buscar Embarcaciones

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

Obtener Embarcaciones en un Área

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

Acceder al Recurso de Embarcación

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

Obtener Historial de Llamadas Portuarias

<use_mcp_tool>
<server_name>marinetraffic</server_name>
<tool_name>get_port_calls</tool_name>
<arguments>
{
  "identifier": "123456789",
  "movetype": "arrival",
  "extended": true
}
</arguments>
</use_mcp_tool>

Obtener Pronóstico de Viaje (ETA Previsto)

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

Acceder al Recurso de Actividad Portuaria

<access_mcp_resource>
<server_name>marinetraffic</server_name>
<uri>port://22541</uri>
</access_mcp_resource>

Limitaciones de la Clave de API

La API de MarineTraffic tiene límites de uso según tu plan de suscripción. Ten en cuenta estos límites al usar el servidor para evitar exceder tu cuota.

get_port_calls y get_voyage_forecast llaman a los servicios de Llamadas Portuarias de Embarcación Individual y Pronóstico de Viaje de Embarcación Individual de MarineTraffic (de la Referencia de la API de Datos AIS). Estos son servicios separados con precios individuales en el catálogo de API de MarineTraffic — tu clave necesita esos servicios específicos habilitados, no solo las posiciones básicas de embarcaciones, o las llamadas a estas dos herramientas fallarán incluso con una clave válida. Ejemplo de información detallada de embarcación disponible a través de la API

Limitaciones de la Clave de API

La API de MarineTraffic tiene límites de uso según tu plan de suscripción. Ten en cuenta estos límites al usar el servidor para evitar exceder tu cuota.

Solución de Problemas

Errores de Clave de API: Asegúrate de que tu clave de API de MarineTraffic sea válida y esté configurada correctamente en las variables de entorno.
Limitación de Velocidad: Si encuentras errores de limitación de velocidad, el servidor reintentará automáticamente con retroceso exponencial, pero es posible que debas esperar antes de realizar solicitudes adicionales.
No se Encontraron Datos: Algunas embarcaciones pueden no tener datos de seguimiento en tiempo real disponibles, especialmente embarcaciones más pequeñas o aquellas en áreas con cobertura AIS limitada.

Licencia

Este proyecto está licenciado bajo la Licencia ISC.