Platforma programistyczna Mariner GPS Tools

Przegląd i szybki start

Korzystaj z tych samych sprawdzonych kalkulatorów nawigacyjnych co Mariner GPS Tools przez JSON REST API lub serwer Model Context Protocol.

Wybierz REST lub MCP

Oba interfejsy używają tego samego silnika obliczeniowego i modelu uprawnień. Użyj REST z kluczem API do aplikacji i skryptów, w których kontrolujesz każde żądanie. Użyj MCP, gdy asystent AI lub agent powinien odkryć dostępne narzędzia, zrozumieć ich schematy i sam wybrać odpowiednie obliczenie.

REST API

Bezpośrednie, wersjonowane żądania

Wywołaj obliczenia nawigacji z aplikacji, usług, automatyzacji i skryptów.

https://marinergps.tools/api/v1

Serwer MCP

Narzędzia dla agentów AI

Pozwól agentom kompatybilnym z MCP odkryć dostępne możliwości i wybrać odpowiednie obliczenia.

https://marinergps.tools/mcp

Uwierzytelnianie

Dwie metody logowania prowadzą do tego samego silnika obliczeniowego. Interaktywne klienty AI łączą się z serwerem MCP i autoryzują dostęp w przeglądarce przez OAuth. Aplikacje, usługi, skrypty i integracje ręczne używają klucza API Mariner GPS Tools wysyłanego jako token Bearer. Klucze można tworzyć za darmo, a także w każdej chwili obracać lub unieważniać.

Utwórz klucz API

Nagłówek Authorizationhttp

Authorization: Bearer mrt_live_...

Szybki start REST

Wyślij żądanie JSON do dowolnego punktu końcowego REST z wersjonowaną wersją, używając klucza API. Odpowiedzi używają spójnegook, data, ierrorstrukturę we wszystkich narzędziach obliczeniowych.

Oblicz łożyskoshell

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

Szybki start MCP

Dodaj adres URL serwera do zgodnego klienta AI i zatwierdź dostęp w przeglądarce, gdy otworzy się strona autoryzacji Mariner Tools. Klient automatycznie wykrywa konfigurację logowania i dostępne narzędzia, bez kopiowania kluczy ani tokenów.

Adres URL serwerahttp

https://marinergps.tools/mcp

Przewodnik konfiguracji krok po kroku

Alternatywa: ręczna konfiguracja z kluczem API

Klienty bez autoryzacji w przeglądarce oraz integracje programistyczne mogą zamiast tego wysyłać klucz API:

Konfiguracja klienta MCPjson

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

Format odpowiedzi REST

Pomyślne odpowiedzi REST zwracają obliczony wynik wdata. Niepowodzenie walidacji i żądań powoduje zwrócenie stabilnego, czytelnego maszynowo kodu błędu wraz z komunikatem czytelnym dla człowieka.

JSON

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

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