Mariner GPS Tools 開発者プラットフォーム

概要とクイックスタート

Mariner GPS Tools を支える検証済みの航海計算ツールを、JSON REST API または Model Context Protocol サーバーから利用できます。

REST または MCP を選択してください

どちらのインターフェイスも同じ計算エンジンと権限モデルを使用します。各リクエストを制御するアプリケーションやスクリプトには、API キーを使用した REST をご利用ください。AI アシスタントやエージェントが利用可能なツールを検出し、そのスキーマを理解し、適切な計算を自ら選択する場合は、MCP をご利用ください。

REST API

バージョン管理された直接リクエスト

アプリケーション、サービス、オートメーション、スクリプトからナビゲーション計算を呼び出します。

https://marinergps.tools/api/v1

MCP サーバー

AIエージェント用ツール

MCP 互換エージェントが利用可能な機能を検出し、適切な計算を選択できるようにします。

https://marinergps.tools/mcp

認証

2 つのサインイン方法で同じ計算エンジンを利用できます。対話型の AI クライアントは MCP サーバーに接続し、ブラウザで OAuth によりアクセスを認可します。アプリケーション、サービス、スクリプト、手動の連携では、Bearer トークンとして送信する Mariner GPS Tools API キーを使用します。キーは無料で作成でき、いつでもローテーションまたは取り消しができます。

API キーを作成する

Authorizationヘッダーhttp

Authorization: Bearer mrt_live_...

REST クイックスタート

API キーを使用して、バージョン管理された REST エンドポイントに JSON リクエストを送信します。応答は一貫したものを使用しますok, data, そしてerrorすべての計算ツールにわたる構造。

方位を計算するshell

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 クイックスタート

対応する AI クライアントにサーバー URL を追加し、Mariner Tools の認可ページが開いたらブラウザでアクセスを承認します。クライアントはサインインの設定と利用可能なツールを自動的に検出するため、コピーするキーやトークンはありません。

サーバー URLhttp

https://marinergps.tools/mcp

ステップバイステップのセットアップガイド

代替方法: API キーを使用した手動構成

ブラウザ認可のないクライアントや、プログラムによる連携では、代わりに API キーを送信できます:

MCP クライアント構成json

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

REST 応答フォーマット

REST 応答が成功すると、次の計算結果が返されます。data. 検証とリクエストが失敗すると、人間が判読できるメッセージとともに、機械が判読できる安定したエラーコードが返されます。

JSON

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

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