Mariner GPS Tools Entwicklerplattform

Übersicht und Schnellstart

Nutze über eine JSON-REST-API oder einen Model-Context-Protocol-Server dieselben getesteten Navigationsrechner, auf denen Mariner GPS Tools basiert.

Wählen Sie REST oder MCP

Beide Schnittstellen verwenden dieselbe Berechnungs-Engine und dasselbe Berechtigungsmodell. Verwenden Sie REST mit einem API-Schlüssel für Anwendungen und Skripte, bei denen Sie jede Anfrage steuern. Verwenden Sie MCP, wenn ein KI-Assistent oder Agent die verfügbaren Tools entdecken, ihre Schemata verstehen und selbst die richtige Berechnung auswählen soll.

REST-API

Direkte, versionierte Anfragen

Rufen Sie Navigationsberechnungen aus Anwendungen, Diensten, Automatisierungen und Skripten auf.

https://marinergps.tools/api/v1

MCP-Server

Tools für KI-Agenten

Lassen Sie MCP-kompatible Agenten die verfügbaren Funktionen entdecken und die entsprechende Berechnung auswählen.

https://marinergps.tools/mcp

Authentifizierung

Zwei Anmeldemethoden erreichen dieselbe Berechnungs-Engine. Interaktive KI-Clients verbinden sich mit dem MCP-Server und autorisieren den Zugriff im Browser mit OAuth. Anwendungen, Dienste, Skripte und manuelle Integrationen verwenden einen Mariner GPS Tools API-Schlüssel, der als Bearer-Token gesendet wird. Schlüssel können kostenlos erstellt und jederzeit rotiert oder widerrufen werden.

Erstellen Sie einen API-Schlüssel

Authorization-Headerhttp

Authorization: Bearer mrt_live_...

REST Schnellstart

Senden Sie mit Ihrem API-Schlüssel eine JSON-Anfrage an einen beliebigen versionierten REST-Endpunkt. Antworten verwenden eine konsistenteok, data, underrorStruktur über alle Berechnungstools hinweg.

Berechnen Sie eine Peilungshell

curl -X POST https://marinergps.tools/api/v1/bearing \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "from": { "lat": 50.1, "lng": -4.2 },
    "to": { "lat": 49.8, "lng": -3.1 }
  }'

MCP Schnellstart

Fügen Sie die Server-URL einem kompatiblen KI-Client hinzu und erlauben Sie den Zugriff in Ihrem Browser, wenn die Mariner Tools-Autorisierungsseite geöffnet wird. Der Client erkennt die Anmeldeeinrichtung und die verfügbaren Tools automatisch, ohne dass Schlüssel oder Token kopiert werden müssen.

Server-URLhttp

https://marinergps.tools/mcp

Schritt-für-Schritt-Einrichtungsanleitung

Alternative: manuelle Konfiguration mit einem API-Schlüssel

Clients ohne Browser-Autorisierung und programmatische Integrationen können stattdessen einen API-Schlüssel senden:

MCP Client-Konfigurationjson

{
  "mcpServers": {
    "mariner-tools": {
      "url": "https://marinergps.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST-Antwortformat

Erfolgreiche REST-Antworten geben das berechnete Ergebnis zurückdata. Bei Validierungs- und Anforderungsfehlern wird neben einer für Menschen lesbaren Meldung ein stabiler, maschinenlesbarer Fehlercode zurückgegeben.

JSON

{
  "ok": true,
  "data": {
    "degrees": 112.7,
    "compass": "ESE"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid bearing input."
  }
}