Maersk Vessel Deadlines

Acesse programaticamente os horários de navios e prazos de embarque da Maersk por meio da API Maersk.

GitHub
1

Documentação

Servidor MCP de Prazos de Navios da Maersk

Este projeto é um servidor Model Context Protocol (MCP) que fornece acesso programático às informações de navios da Maersk, incluindo cronogramas de navios e prazos de embarque. Ele expõe ferramentas que podem ser usadas por clientes compatíveis com MCP (como Claude Desktop, GPTs ou outros assistentes de IA) para recuperar dados de transporte atualizados das APIs públicas da Maersk.

Sobre o Model Context Protocol (MCP)

O Model Context Protocol é um padrão aberto que permite que assistentes de IA se conectem a fontes de dados e ferramentas externas. Servidores MCP fornecem uma maneira padronizada para modelos de IA acessarem informações em tempo real e executarem ações por meio de uma interface segura e estruturada.

Recursos e Ferramentas Disponíveis

O servidor MCP expõe as seguintes ferramentas:

1. get_vessel_imo

  • Descrição: Recupera o número IMO (Organização Marítima Internacional) de um navio pelo seu nome.
  • Entrada: Nome do navio (string)
  • Saída: Número IMO (string)

2. get_vessel_schedule

  • Descrição: Recupera o cronograma e os prazos de embarque de um navio, dado seu número IMO, número da viagem, porto de embarque e código de país ISO.
  • Entradas:
    • vessel_imo: Número IMO do navio (string)
    • voyage_number: Número da viagem (string)
    • port_of_loading: Porto de embarque (string)
    • iso_country_code: Código de país ISO do porto (string)
  • Saída: Resumo legível do cronograma e prazos do navio

3. get_port_calls

  • Descrição: Recupera os navios que farão escala em um porto específico, dado seu País e Cidade de Porto de Embarque para a próxima semana.
  • Entradas:
    • country_code: Código de país ISO
    • city_name: Nome da cidade do POL
  • Saída: Resumo legível dos navios que farão escala no porto na próxima semana.

Essas ferramentas estão definidas em main.py e são acessíveis via protocolo MCP para integração com assistentes de IA e outros clientes MCP.

Requisitos

  • Python 3.11+
  • Chave de Consumidor da API Maersk (definida como CONSUMER_KEY no seu ambiente)

Instalação e Uso

Usando Docker (Recomendado)

Uma imagem Docker pré-construída está disponível em dipankan001/maersk-mcp:v1:

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

Conectando a Clientes MCP

Claude Desktop

Adicione isto à sua configuração do Claude Desktop:

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

Outros Clientes MCP

Para outros clientes compatíveis com MCP, configure o servidor usando o método de conexão apropriado (HTTP, stdio, etc.) conforme especificado na especificação MCP.

Endpoints

O aplicativo expõe ferramentas MCP para:

  • Obter números IMO de navios
  • Buscar cronogramas de navios e prazos de embarque
  • Buscar navios com escalas ativas em portos

Consulte main.py para detalhes sobre as ferramentas disponíveis e seus parâmetros.

Recursos