MarineTraffic MCP Server

Fornece acesso aos dados de rastreamento de embarcações do MarineTraffic.

GitHub

Documentação

Servidor MCP MarineTraffic

Um servidor Model Context Protocol (MCP) que fornece acesso aos dados de rastreamento de embarcações da MarineTraffic.

Recursos

Este servidor MCP oferece as seguintes capacidades:

Ferramentas

get_vessel_position: Obter a posição em tempo real de uma embarcação pelo número MMSI ou IMO
get_vessel_details: Obter informações detalhadas sobre uma embarcação pelo número MMSI ou IMO
search_vessels: Buscar embarcações por nome, MMSI, IMO ou tipo de embarcação
get_vessels_in_area: Obter embarcações em uma área geográfica especificada
get_port_calls: Obter o histórico de chamadas de porto de chegada/partida para uma embarcação pelo número MMSI ou IMO (dados disponíveis para datas após 2015-01-16)
get_voyage_forecast: Obter a previsão de viagem por aprendizado de máquina para uma embarcação pelo número MMSI ou IMO — próximo porto e ETA previstos, combinando posição AIS ao vivo com histórico de rotas

Recursos

vessel://{identificador}: Informações sobre uma embarcação pelo número MMSI ou IMO
vessels://area/{lat}/{lon}/{raio}: Lista de embarcações em uma área geográfica especificada
port://{port_id}: Chamadas de porto de chegada/partida recentes para um porto, pelo ID de porto da MarineTraffic ou UN/LOCODE

Instalação

Instalando via Smithery

Para instalar o MarineTraffic Vessel Tracking Server para Claude Desktop automaticamente via Smithery:

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

Pré-requisitos

Node.js 18 ou superior
Uma chave de API da MarineTraffic (disponível em MarineTraffic API Services)

Configuração

Clone este repositório ou baixe o código-fonte
Instale as dependências:

cd marinetraffic-server
npm install

Compile o servidor:

npm run build

Configuração

O servidor requer uma chave de API da MarineTraffic para funcionar. Você pode fornecê-la através da variável de ambiente MARINETRAFFIC_API_KEY.

Configuração de Configurações MCP

Para usar este servidor com Claude, adicione-o ao seu arquivo de configuração de configurações MCP:

Para o Aplicativo Claude Desktop (macOS)

Edite ~/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 a Extensão Claude VSCode

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

Exemplos de Uso

Uma vez que o servidor esteja configurado e em execução, você pode usá-lo com Claude para acessar dados de rastreamento de embarcações:

Obter Posição da Embarcação

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

Buscar Embarcações

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

Obter Embarcações em Á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>

Acessar Recurso de Embarcação

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

Obter Histórico de Chamadas de Porto

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

Obter Previsão de Viagem (ETA Previsto)

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

Acessar Recurso de Atividade do Porto

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

Limitações da Chave de API

A API da MarineTraffic tem limites de uso baseados no seu plano de assinatura. Esteja ciente desses limites ao usar o servidor para evitar exceder sua cota.

get_port_calls e get_voyage_forecast chamam os serviços de Chamadas de Porto de Embarcação Única e Previsão de Viagem de Embarcação Única da MarineTraffic (da Referência da API de Dados AIS). Esses são serviços separados, com preços individuais, no catálogo de API da MarineTraffic — sua chave precisa desses serviços específicos habilitados, não apenas posições básicas de embarcações, ou as chamadas para essas duas ferramentas falharão mesmo com uma chave válida. Exemplo de informações detalhadas de embarcação disponíveis através da API

Limitações da Chave de API

A API da MarineTraffic tem limites de uso baseados no seu plano de assinatura. Esteja ciente desses limites ao usar o servidor para evitar exceder sua cota.

Solução de Problemas

Erros de Chave de API: Certifique-se de que sua chave de API da MarineTraffic seja válida e esteja configurada corretamente nas variáveis de ambiente.
Limitação de Taxa: Se você encontrar erros de limitação de taxa, o servidor tentará automaticamente novamente com backoff exponencial, mas você pode precisar aguardar antes de fazer solicitações adicionais.
Nenhum Dado Encontrado: Algumas embarcações podem não ter dados de rastreamento em tempo real disponíveis, especialmente embarcações menores ou aquelas em áreas com cobertura AIS limitada.

Licença

Este projeto é licenciado sob a Licença ISC.