Teckel Navigation Toolkit

ナビゲーションツールキット

この MCP サーバーを使うと、LLM／AI／エージェントが正確なナビゲーション情報を提供できます。主な用途は 3 つあり（すべて組み合わせて利用できます）、時間と場所、ロードトリップ、一般航空です。

時間と場所

タイムゾーンと夏時間の補正を考慮し、世界中のあらゆる場所の現地時刻と太陽の位置を正確に判定します。

これらのツールを使用する LLM プロンプトの例：

「今年の 6 月 15 日、マン島では日照時間が何時間ありますか？」

「香港の現在時刻と、明るさの状況（日中、薄明、暗闇）を教えてください。」

「明日、ドイツのハンブルクの日の出と日の入りは何時ですか？」

「3 時間後にロンドンからサンフランシスコへ向けて出発します。フライトは 10 時間かかります。サンフランシスコに到着するのは何時で、そのときの明るさの状況はどうなっていますか？」

ロードトリップ

現在の交通状況を考慮し（海を渡る必要がある場合はフェリーの所要時間も含め）、世界中のあらゆる場所までの運転距離と所要時間を正確に判定します。住所、郵便番号、名称、ランドマークなどで指定された場所の緯度と経度を算出します。任意の場所から指定した範囲内にあるホテル、レストランなど、一般的な施設を検索します。

これらのツールを使用する LLM プロンプトの例：

「ジョシュアツリーからカリフォルニア州オークランドまでの距離と、車での所要時間を教えてください。」

「英国のプレストウィック空港から 20 マイル以内にあるホテルを 10 件探してください。」

「英国の郵便番号 IM4 7BN の緯度と経度を教えてください。」

「明日、現地時間の午前 9 時にベルリンからミュンヘンまで車で移動する場合、到着時には暗くなっていますか？」

一般航空

以下のツールを提供します

• 地球の形状と大きさを扁球として定義し、全地球測位システム（GPS）の標準として用いられている測地基準系、World Geodetic System 1984（WGS84）を使用して、地球上の地点間の距離を正確に計算します。距離は、大圏航路（2地点間の最短距離）または航程線（メルカトル図法の地図上に引いた直線に沿って測定した距離）のいずれかで計算できます。
• 指定した出発地点、方位、距離に基づいて、到着地点を正確に計算します。方位は真北または磁北を基準に指定できます（磁北を基準にする場合は、磁気偏角を自動的に計算して補正します）。航路は大圏航路または航程線として指定できます。
• 世界中の任意の地点から指定範囲内にある空港を、複数の任意のフィルター（「AVGASを備えていること」など）を使用して検索します。米国内に限り、航法援助施設、フィックス、地物、障害物も検索できます。
• 世界各地のICAO指定気象観測所について、最新の航空気象レポート（METAR）と予報（TAF）を取得します（生データ形式とデコード済み形式）。
• 指定した地点に最も近いICAO指定気象観測所、またはその地点から指定範囲内にある複数の観測所を検索します。
• 測定された気温と気圧（METARから取得）に基づき、高度ごとの航空関連大気パラメーターを計算します。
• 指定した出発地と目的地の飛行場間のVFR（有視界飛行方式）飛行ルートを計算します。直行ルートでない場合は、中間ウェイポイントを最大10か所まで指定できます。
• ルート上の最新METARと、地上10mで測定されたMETARの風から上空の風をべき乗則で外挿する想定に基づいて、風補正、磁気偏角、日照状況を自動計算します。日照状況には、各ウェイポイントでの日中、薄明、夜間の判定や、飛行経路を基準にした太陽の方向（方位角と天頂角。まぶしさが問題になるかどうかの評価に使用）などが含まれます。
• 出発地および到着地の飛行場について、各滑走路の基本情報（路面、寸法）と、横風および向かい風・追い風の成分（最新METARから計算）を提供します。また、情報がある場合は、滑走路灯火、視覚進入援助施設、計器進入援助施設の詳細も提供します。
• 出発地および到着地の飛行場の通信周波数も提供します。また、情報がある場合は、電話連絡先、運用時間、PPRの要否も提供します。
• 最新のMETARデータに基づく現在の大気条件を使用して、大気（および国際標準大気からの偏差）をモデル化します。これにより、たとえば出発地の飛行場における密度高度、真対気速度（TAS）、マッハ数、ルート上の推定雲底高度と着氷高度、および各ウェイポイントの気圧高度（標準気圧に設定した高度計に表示される高度。フライトレベルの決定に役立ちます）を計算します。
• すべての航法所要時間は、UTCと現地時刻の両方で表示されます（タイムゾーンと夏時間の補正を考慮）。ルートの概要（総距離、飛行時間、燃料消費量）に加え、ナビゲーションログの作成に必要な関連データを各区間ごとに提供します（対地速度、距離、所要時間、磁方位と真航跡、使用燃料など）。
• 航空機の性能とルートプロファイルのデータ（指示対気速度、高度、燃料流量）は指定できます。省略された場合は、既定値（100kts、2500ft、8 USgal/hour）を使用します。
• 各ウェイポイントについて、最新のMETAR（現在の気象状況）とTAF（予報）を提供します。
• skyvector.comでルートを表示するためのURLも提供します（ウェブブラウザーからアクセスできます）。表示したルートは、Garmin Pilot、ForeFlightなどの一般的なパイロットアプリにエクスポートできます。

### これらのツールを使用した LLM プロンプトの例：

「英国のプレストウィック空港とグッドウッド飛行場の間の大圏距離はどれくらいですか？」

「EGNS から真方位 335 度で 25 海里の地点の緯度と経度を教えてください。」

「英国のダベントリー VOR（DTY）から磁方位 85 度で 45 海里の地点の緯度と経度を教えてください。」

「英国のウォルバーハンプトン空港に最も近い METAR 報告を教えてください。」

「英国のウォルバーハンプトン空港から EGTK までの VFR 飛行ルートを計算してください。中間ウェイポイントは、ウォルバーハンプトンから磁方位 210 度で 15 海里の地点です。指示対気速度は 95 kts、高度は 2000 ft、ウォルバーハンプトンを出発するのは 45 分後です。ナビゲーションログの詳細と skyvector URL を提示してください。」

続けて、 「EGTK からチッピング・ノートンまで車でどれくらいかかりますか？」

「カリフォルニア州のパロアルト空港から同州のハーフムーンベイ空港までの VFR 飛行ルートを計算してください。中間ウェイポイントはスタンフォード大学上空を通過します。指示対気速度は 100 kts、高度は 3000 ft、パロアルトを出発するのは 2 時間後です。ナビゲーションログの詳細と skyvector URL を提示してください。」

続けて、 「ハーフムーンベイ空港から 10 マイル以内にメキシコ料理のレストランはありますか？」

次の 2 つの例では、あらゆる水上ルートに制限があることに注意してください。

「今週、リバプールを出発し、最終目的地をダブリンとする VFR 飛行計画を提示してください。すべてのウェイポイントで AVGAS を利用できることを確認し、各ウェイポイントから半径 5 マイル以内の宿泊施設を 3 か所提示してください。50 海里を超える水上横断がないことを確認してください。航空機は小型の単発 Cessna です。最大飛行高度を 8000ft 未満にしてください。各ウェイポイントと最終目的地への着陸時に、日照時間が最低 1 時間残っていることを確認してください。飛行時間と移動時間の合計を最小限に抑える最適な飛行行程を提示してください。飛行制限に対応して安全に飛行できるよう、航路上の気象状況を確認してください。12 月 31 日の午後 2 時までにダブリンに到着する必要があります。skyvector URL も提示してください。」

出力（PDF の書き起こし）

「明日の朝、カリフォルニア州ユッカバレーを出発し、最終目的地を MIA とする、小型 Cessna 用の VFR 限定飛行計画を作成してください。航続距離は 300nm のみで、AVGAS を利用できる空港にのみ着陸してください。50nm を超える水上ルートは避けてください。最大飛行高度は 9000ft です。目的地を含むすべてのウェイポイントへの着陸時に、日照時間が少なくとも 1 時間残っている必要があります。各ウェイポイントから半径 5 マイル以内で利用可能な宿泊施設を 3 か所以上挙げてください。移動時間の合計を最小限に抑える詳細な行程を含めてください。skyvector URL も含めてください。」

出力（PDF の書き起こし）

teckel Navigation Toolkit に関するさらに詳しい歴史的な解説については、こちらのブログ記事をご覧ください。

teckel ツールキットの使い方

まず、teckel アプリをダウンロードしてインストールしてください。

次に、teckel Appを使ってAPIキーを生成します。

次の手順を行います。

1. Appのホーム画面右上にあるウォレットアイコンをタップして、Accountsページに移動します。Accountsページで「Manage API Key」をタップし、作成またはインポートしたEthereumアカウントのAPI Key Managerにアクセスします。

2. エンドポイントを呼び出す際にAPIキーを使用します。利用可能なすべてのエンドポイントはteckel Appから利用でき、指定したEthereumアカウントの実際のAPIキーが組み込まれています。

3. 説明用として、以下の例では偽のキーd1e12345-c234-45a6-9b76-1234567891ffを使用します。この偽のキーの代わりに、実際のAPIキーを使用してください。

次に、MCP サーバーとRESTful（API）のどちらを使ってツールにアクセスするかを決めます。

MCP サーバーの使用

使用するMCPクライアントを設定する

どのクライアントでも、設定は基本的に同じです。つまり、MCP サーバーのエンドポイントとアクセス認証情報をクライアントに指定します。通常は、APIキーを「Authorization」タグの「Bearer」トークンとして使用する設定JSONスニペットの形式で指定します。たとえば、Cursorデスクトップアプリで使用するための正確な設定は以下のとおりです（Cursorアプリ内でCursor Settings -> Tools & MCP -> + New MCP serverに移動し、実際のteckel APIキーをこの偽のキーの代わりに入力します）。

MCP JSON設定（Cursorでの使用例）

{
 "mcpServers": {    
    "teckel-navigation-toolkit": {
      "url": "https://mcp-servers.bh.tkllabs.io:9780/navigation-mcp",
      "headers": {
        "Authorization": "Bearer d1e12345-c234-45a6-9b76-1234567891ff"
      }
    }   
  }
}

注：この設定ではHTTP（streamable）プロトコルを想定しています。クライアントで以前の（現在はレガシーとなった）SSEプロトコルが必要な場合は、「navigation-mcp」を「navigation-sse」に置き換えてください。

MCP JSON設定（n8nでの使用例）

同様に、n8nで使用する場合、teckel EthereumおよびNavigation ToolkitsのMCP サーバーにアクセスするサンプルワークフローのJSONコードスニペットを以下に示します。（このスニペット全体を.jsonファイルに保存し、そのファイルをn8nワークフローにインポートしてください。）n8nで独自の「Bearer Auth」認証情報に置き換える必要があります（teckel APIキーを「Bearer token」として使用します）。

{
  "name": "Teckel Tools MCP Example",
  "nodes": [
    {
      "parameters": {
        "endpointUrl": "https://mcp-servers.bh.tkllabs.io:9780/ethereum-mcp",
        "authentication": "bearerAuth",
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.mcpClientTool",
      "typeVersion": 1.2,
      "position": [
        -16,
        640
      ],
      "id": "569bf922-b8cb-40a0-beb8-2da890dab925",
      "name": "Teckel Tools MCP server: ethereum",
      "credentials": {
        "httpBearerAuth": {
          "id": "zPHt516IS5uuS2S5",
          "name": "TECKEL APIKEY"
        }
      }
    },
    {
      "parameters": {
        "modelId": {
          "__rl": true,
          "value": "gpt-5",
          "mode": "list",
          "cachedResultName": "GPT-5"
        },
        "messages": {
          "values": [
            {
              "content": "Perform a VFR flight route calculation from EGNS to EGPK, departing 60 minutes from now. Include an intermediate waypoint on magnetic bearing 320 degrees at 20 nm from EGNS, followed by another on true bearing 355 for 15 nm from the previous waypoint.\n"
            }
          ]
        },
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.openAi",
      "typeVersion": 1.8,
      "position": [
        -496,
        368
      ],
      "id": "5c9a94cd-71a4-4d77-84f5-664ef14871af",
      "name": "Message a model",
      "credentials": {
        "openAiApi": {
          "id": "EvoF3L2GoYTtESR3",
          "name": "OpenAi account"
        }
      }
    },
    {
      "parameters": {
        "endpointUrl": "https://mcp-servers.bh.tkllabs.io:9780/navigation-mcp",
        "authentication": "bearerAuth",
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.mcpClientTool",
      "typeVersion": 1.2,
      "position": [
        192,
        640
      ],
      "id": "016dae90-92b4-4eed-9120-f8531bafbd10",
      "name": "Teckel Tools MCP server: navigation",
      "credentials": {
        "httpBearerAuth": {
          "id": "zPHt516IS5uuS2S5",
          "name": "TECKEL APIKEY"
        }
      }
    }
  ],
  "pinData": {},
  "connections": {
    "Teckel Tools MCP server: ethereum": {
      "ai_tool": [
        [
          {
            "node": "Message a model",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    },
    "Teckel Tools MCP server: navigation": {
      "ai_tool": [
        [
          {
            "node": "Message a model",
            "type": "ai_tool",
            "index": 0
          }
        ]
      ]
    }
  },
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "626e0784-a43b-4857-bf54-91e7f1c32c59",
  "meta": {
    "templateId": "self-building-ai-agent",
    "templateCredsSetupCompleted": true,
    "instanceId": "3c7702199c1f42229c256ae3782d70f8576bc5028e557d0903826477f97e032b"
  },
  "id": "rAm1XjSle8lYmOcT",
  "tags": []
}

RESTful API サーバーの使用

MCP サーバーを使用する利点は、接続されたLLMがユーザープロンプト内の自然言語を解析し、ツールボックスAPI関数の呼び出しに必要なパラメーターを設定してから、返されたJSON構造を同様に自然言語に展開してユーザーに提示できることです。ただし、teckelツールキットをより低いレベルで使用する場合（例：独自のアプリ内で使用する場合）は、RESTful（POST）APIプロトコルを使って関数を直接呼び出すことができます。その場合は、入力パラメーターの設定と、返されるJSON出力の処理を自分で行う必要があります。

ベースAPI URLエンドポイントは、MCP サーバーのエンドポイントと同じです。

https://mcp-servers.bh.tkllabs.io:9780/

目的の関数名をこのURLに追加し、関数の引数をクエリ文字列パラメーターとして追加する必要があります。teckel APIキーは、AuthorizationヘッダーにBearer Tokenとして追加する必要があります。GETではなくPOSTプロトコルを使用する必要がありますが、パラメーターはクエリ文字列で渡されるため、ボディは空でもかまいません。以下は、Navigation Toolkitの_perform_sun_calculations_を必要なパラメーターとともに呼び出すcurlリクエストの例です。

Curlリクエスト

curl -X POST \   'https://mcp-servers.bh.tkllabs.io:9780/perform_sun_calculations?latitude=54&longitude=-4.4861228&altitudeMetres=100&dateTimeUTCstr=25-Oct-2025%2014:18:39' \
  -H 'Authorization: Bearer d1e12345-c234-45a6-9b76-1234567891ff' \
  -H 'Content-Type: application/json'

JSONレスポンス

{"results":{"sunElevation":17.66329058182842,"sunAzimuth":215.1455213675287,"sunriseUTC":"25-Oct-2025 07:04:51","sunriseAzimuth":109.78189990283305,"sunsetUTC":"25-Oct-2025 16:58:17","sunsetAzimuth":249.96470561181022,"middayUTC":"25-Oct-2025 12:01:38","middaySunElevation":23.75305488041259,"daylightHours":"09:53:26"}}

関数（ツール）一覧

ツールキットで利用できる関数の完全な一覧は、https://teckel.io/ai-mcp-services/ で確認できます。

料金

ツールキット内の各関数の利用料金（teckel App内で購入する_teckel credits_による）は、https://teckel.io/ai-mcp-services/ で確認できます。

レート制限

すべてのMCP/API呼び出しには、APIキーごとのレート制限が適用されます。しきい値は公開されていませんが、指定したAPIキーがレート制限を超えた場合、該当する呼び出しに対して429エラーコードが返されます。

エラー

ユーザーのエラーにより MCP/API 呼び出しが失敗し、4xx エラーコードが返された場合、ユーザーには Base Call Fee が 1 回分課金されます（https://teckel.io/ai-mcp-services/ を参照）。API 呼び出しがサーバーエラーにより失敗し、5xx エラーコードが返された場合、ユーザーには課金されません。指定された呼び出しがネストされた呼び出しのカスケードの一部である場合、上記のルールは「外側」の呼び出しに適用されます。つまり、外側の呼び出しが 4xx エラーコードで失敗した場合、ユーザーには Base Call Fee が 1 回分（失敗した外側の呼び出し分）課金され、カスケード内の呼び出しについては、成功したかどうかにかかわらず課金されません。同様に、外側の呼び出しが 5xx エラーコードで失敗した場合、カスケード内の呼び出しが成功していても、ユーザーには一切課金されません。

API キーのセキュリティに関する注意

API キーが漏えいした可能性があり、誰かがそのキーを使って teckel クレジットを消費している懸念がある場合は、teckel App の API Key Manager → Replace API key からキーを置き換えてください。古いキーはすぐに無効になります。