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

Related MCP server: Satellite Tracking MCP Server

Instalación

Prerrequisitos

• Node.js 18 o superior

• Una clave API de MarineTraffic (disponible en MarineTraffic API Services )

Configuración

1. Clona este repositorio o descarga el código fuente

2. Instalar dependencias:

cd marinetraffic-server
npm install

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