MarineTraffic MCP Server

Ein Model Context Protocol (MCP)-Server, der Zugriff auf Schiffsverfolgungsdaten von MarineTraffic bietet.

Merkmale

Dieser MCP-Server bietet die folgenden Funktionen:

Werkzeuge

• get_vessel_position : Echtzeitposition eines Schiffes per MMSI- oder IMO-Nummer abrufen

• get_vessel_details : Erhalten Sie detaillierte Informationen zu einem Schiff anhand der MMSI- oder IMO-Nummer

• search_vessels : Suche nach Schiffen nach Name, MMSI, IMO oder Schiffstyp

• get_vessels_in_area : Schiffe in einem bestimmten geografischen Gebiet abrufen

Ressourcen

• vessel://{identifier} : Informationen zu einem Schiff per MMSI- oder IMO-Nummer

• ships://area/{lat}/{lon}/{radius} : Liste der Schiffe in einem bestimmten geografischen Gebiet

Related MCP server: Satellite Tracking MCP Server

Installation

Installation über Smithery

So installieren Sie den MarineTraffic Vessel Tracking Server für Claude Desktop automatisch über Smithery :

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

Voraussetzungen

• Node.js 18 oder höher

• Ein MarineTraffic API-Schlüssel (erhältlich bei MarineTraffic API Services )

Aufstellen

1. Klonen Sie dieses Repository oder laden Sie den Quellcode herunter

2. Installieren Sie Abhängigkeiten:

cd marinetraffic-server
npm install

3. Erstellen Sie den Server:

npm run build

Konfiguration

Der Server benötigt einen MarineTraffic API-Schlüssel, um zu funktionieren. Sie können diesen über die Umgebungsvariable MARINETRAFFIC_API_KEY bereitstellen.

MCP-Einstellungskonfiguration

Um diesen Server mit Claude zu verwenden, fügen Sie ihn Ihrer MCP-Einstellungskonfigurationsdatei hinzu:

Für die Claude Desktop App (macOS)

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

Für Claude VSCode-Erweiterung

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

Anwendungsbeispiele

Sobald der Server konfiguriert und ausgeführt wird, können Sie ihn mit Claude verwenden, um auf Schiffsverfolgungsdaten zuzugreifen:

Schiffsposition abrufen

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

Suche nach Schiffen

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

Schiffe in der Umgebung abrufen

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

Zugangsschiffsressource

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

API-Schlüsselbeschränkungen

Die MarineTraffic API unterliegt Nutzungsbeschränkungen, die von Ihrem Abonnement abhängen. Beachten Sie diese Beschränkungen bei der Nutzung des Servers, um Ihr Kontingent nicht zu überschreiten.

Fehlerbehebung

• API-Schlüsselfehler : Stellen Sie sicher, dass Ihr MarineTraffic-API-Schlüssel gültig und in den Umgebungsvariablen richtig festgelegt ist.

• Ratenbegrenzung : Wenn bei der Ratenbegrenzung Fehler auftreten, führt der Server automatisch einen erneuten Versuch mit exponentiellem Backoff durch. Sie müssen jedoch möglicherweise warten, bevor Sie weitere Anfragen stellen können. Beispiel für detaillierte Schiffsinformationen, die über die API verfügbar sind.

API-Schlüsselbeschränkungen

Die MarineTraffic API unterliegt Nutzungsbeschränkungen, die von Ihrem Abonnement abhängen. Beachten Sie diese Beschränkungen bei der Nutzung des Servers, um Ihr Kontingent nicht zu überschreiten.

Fehlerbehebung

• API-Schlüsselfehler : Stellen Sie sicher, dass Ihr MarineTraffic-API-Schlüssel gültig und in den Umgebungsvariablen richtig festgelegt ist.

• Ratenbegrenzung : Wenn bei der Ratenbegrenzung Fehler auftreten, versucht der Server es automatisch erneut mit exponentiellem Backoff. Möglicherweise müssen Sie jedoch warten, bevor Sie weitere Anfragen stellen.

• Keine Daten gefunden : Für einige Schiffe sind möglicherweise keine Echtzeit-Tracking-Daten verfügbar, insbesondere für kleinere Schiffe oder Schiffe in Gebieten mit eingeschränkter AIS-Abdeckung.

Lizenz

Dieses Projekt ist unter der ISC-Lizenz lizenziert.