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

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

Klonen Sie dieses Repository oder laden Sie den Quellcode herunter
Installieren Sie Abhängigkeiten:

cd marinetraffic-server
npm install

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

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.

MarineTraffic MCP Server