MarineTraffic MCP Server

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

GitHub
9
Experimente este MCPPatrocinado

Documentação

MarineTraffic MCP Server

smithery badge

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: Obtenha a posição em tempo real de uma embarcação pelo número MMSI ou IMO
  • get_vessel_details: Obtenha informações detalhadas sobre uma embarcação pelo número MMSI ou IMO
  • search_vessels: Busque embarcações por nome, MMSI, IMO ou tipo de embarcação
  • get_vessels_in_area: Obtenha embarcações em uma área geográfica especificada

Recursos

  • vessel://{identifier}: Informações sobre uma embarcação pelo número MMSI ou IMO
  • vessels://area/{lat}/{lon}/{radius}: Lista de embarcações em uma área geográfica especificada

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

Configuração

  1. Clone este repositório ou baixe o código-fonte
  2. Instale as dependências:
cd marinetraffic-server
npm install
  1. 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 das definições do MCP

Para usar este servidor com o Claude, adicione-o ao seu arquivo de configuração de definições do 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

Depois que o servidor estiver configurado e em execução, você pode usá-lo com o 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 uma Á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>

Limitações da Chave de API

A API da MarineTraffic possui 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 pode ser necessário aguardar antes de fazer solicitações adicionais. Exemplo de informações detalhadas de embarcação disponíveis através da API

Limitações da Chave de API

A API da MarineTraffic possui 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 pode ser necessário 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.