Maersk Vessel Deadlines

Accede a los horarios de los buques de Maersk y las fechas límite de envío de forma programática a través de la API de Maersk.

GitHub
1

Documentación

Servidor MCP de Maersk Vessel Deadlines

Este proyecto es un servidor de Model Context Protocol (MCP) que proporciona acceso programático a la información de buques de Maersk, incluyendo horarios de buques y fechas límite de envío. Expone herramientas que pueden ser utilizadas por clientes compatibles con MCP (como Claude Desktop, GPTs u otros asistentes de IA) para recuperar datos de envío actualizados de las API públicas de Maersk.

Acerca del Model Context Protocol (MCP)

El Model Context Protocol es un estándar abierto que permite a los asistentes de IA conectarse a fuentes de datos y herramientas externas. Los servidores MCP proporcionan una forma estandarizada para que los modelos de IA accedan a información en tiempo real y realicen acciones a través de una interfaz segura y estructurada.

Características y herramientas disponibles

El servidor MCP expone las siguientes herramientas:

1. get_vessel_imo

  • Descripción: Obtener el número IMO (Organización Marítima Internacional) de un buque por su nombre.
  • Entrada: Nombre del buque (cadena)
  • Salida: Número IMO (cadena)

2. get_vessel_schedule

  • Descripción: Obtener el horario y las fechas límite de envío de un buque, dado su número IMO, número de viaje, puerto de carga y código de país ISO.
  • Entradas:
    • vessel_imo: Número IMO del buque (cadena)
    • voyage_number: Número de viaje (cadena)
    • port_of_loading: Puerto de carga (cadena)
    • iso_country_code: Código de país ISO del puerto (cadena)
  • Salida: Resumen legible por humanos del horario y las fechas límite del buque

3. get_port_calls

  • Descripción: Obtener los buques que hacen escala en un puerto específico, dado su país y ciudad de puerto de carga para la próxima semana.
  • Entradas:
    • country_code: Código de país ISO
    • city_name: Nombre de la ciudad POL
  • Salida: Resumen legible por humanos de los buques que hacen escala en el puerto en la próxima semana.

Estas herramientas están definidas en main.py y son accesibles a través del protocolo MCP para su integración con asistentes de IA y otros clientes MCP.

Requisitos

  • Python 3.11+
  • Clave de consumidor de la API de Maersk (configurada como CONSUMER_KEY en su entorno)

Instalación y uso

Usando Docker (recomendado)

Una imagen Docker preconstruida está disponible en dipankan001/maersk-mcp:v1:

docker pull dipankan001/maersk-mcp:v1
docker run -e CONSUMER_KEY=INSERT_API_KEY_HERE dipankan001/maersk-mcp:v1

Conexión a clientes MCP

Claude Desktop

Agregue esto a su configuración de Claude Desktop:

{
  "mcpServers": {
    "maersk-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "CONSUMER_KEY=<INSERT_API_KEY_HERE>", "dipankan001/maersk-mcp:v1"]
    }
  }
}

Otros clientes MCP

Para otros clientes compatibles con MCP, configure el servidor utilizando el método de conexión apropiado (HTTP, stdio, etc.) según lo especificado en la especificación MCP.

Endpoints

La aplicación expone herramientas MCP para:

  • Obtener números IMO de buques
  • Obtener horarios de buques y fechas límite de envío
  • Obtener buques con escalas portuarias activas

Consulte main.py para obtener detalles sobre las herramientas disponibles y sus parámetros.

Recursos