Servidor MCP de MarineTraffic

Un servidor de Protocolo de Contexto 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 : obtiene la posición en tiempo real de un barco mediante MMSI o número IMO
get_vessel_details : Obtenga información detallada sobre un buque por número MMSI o IMO
search_vessels : busca buques por nombre, MMSI, IMO o tipo de buque
get_vessels_in_area : Obtener buques en un área geográfica específica

Recursos

buque://{identificador} : Información sobre un buque por número MMSI o IMO
ships://area/{lat}/{lon}/{radius} : Lista de buques en un área geográfica específica

Instalación

Prerrequisitos

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

Configuración

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

cd marinetraffic-server
npm install

Construir el servidor:

npm run build

Configuración

El servidor requiere una clave API de MarineTraffic para funcionar. Puede proporcionarla mediante la variable de entorno MARINETRAFFIC_API_KEY .

Configuración de ajustes de MCP

Para utilizar este servidor con Claude, agréguelo a su archivo de configuración de MCP:

Para la aplicación de escritorio de Claude (macOS)

Editar ~/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 VSCode de Claude

Editar ~/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 funcionando, puedes usarlo con Claude para acceder a los datos de seguimiento de embarcaciones:

Obtener la posición del buque

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

Búsqueda de buques

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

Recurso de acceso al buque

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

Limitaciones de la clave API

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

Solución de problemas

Errores de clave API : asegúrese de que su clave API de MarineTraffic sea válida y esté configurada correctamente en las variables de entorno.
Limitación de velocidad : Si se producen errores de limitación de velocidad, el servidor reintentará automáticamente con una reducción exponencial, pero es posible que deba esperar antes de realizar solicitudes adicionales. Ejemplo de información detallada del buque disponible a través de la API.

Limitaciones de la clave API

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

Solución de problemas

Errores de clave API : asegúrese de que su clave API de MarineTraffic sea válida y esté configurada correctamente en las variables de entorno.
Limitación de velocidad : si encuentra errores de limitación de velocidad, el servidor volverá a intentarlo automáticamente con una reducción exponencial, pero es posible que deba esperar antes de realizar solicitudes adicionales.
No se encontraron datos : es posible que algunas embarcaciones no tengan datos de seguimiento en tiempo real disponibles, especialmente las embarcaciones más pequeñas o aquellas en áreas con cobertura AIS limitada.

Licencia

Este proyecto está licenciado bajo la licencia ISC.

MarineTraffic MCP Server

Integrations