Teckel Navigation Toolkit

导航工具包

此 MCP 服务赋予大模型/AI/Agent 提供准确信息导航的能力。主要有三个应用领域（可组合使用）：时间与地点、公路旅行和通用航空。

时间与地点

准确确定世界各地的当地时间和太阳位置，并考虑时区和夏令时调整。

使用这些工具的 LLM 提示词示例：

“今年 6 月 15 日，马恩岛的日照时间有多少小时？”

“现在香港几点？光照条件如何（日光、曙暮光还是黑暗）？”

“德国汉堡明天的日出和日落时间是什么时候？”

“我的航班将在 3 小时后从伦敦飞往旧金山。飞行时间为 10 小时。我抵达旧金山时当地时间是几点，光照条件如何？”

公路旅行

准确确定世界各地的行车距离和时间，并考虑当前路况（如需渡水，也会计算轮渡航程时间）。计算通过地址、邮政编码、名称、地标等指定的任意地点的纬度和经度。搜索指定地点一定范围内的酒店、餐厅或其他常见场所。

使用这些工具的 LLM 提示词示例：

“从 Joshua Tree 开车到加利福尼亚州 Oakland 有多远，需要多长时间？”

“帮我找出英国 Prestwick Airport 周围 20 英里内的 10 家酒店。”

“英国邮政编码 IM4 7BN 的纬度和经度是多少？”

“如果我明天上午 9 点按当地时间从 Berlin 开车前往 Munich，抵达时天会黑吗？”

通用航空

提供以下工具

• 使用世界大地测量系统 1984（WGS84）精确计算地球上两点之间的距离。WGS84 是定义地球形状和大小的参考大地坐标系，将地球视为扁球体，也是全球定位系统（GPS）的标准。距离可按大圆航线（即两点之间的最短距离）或恒向线（即沿墨卡托投影地图上直线测量的距离）计算。
• 根据给定的起点、方位和航程，精确计算终点。方位可参考真北或磁北（若参考磁北，则会自动计算并校正磁偏角），航迹可指定为大圆航线或恒向线。
• 搜索世界任意位置指定范围内的机场，并可选用多种筛选条件（例如“必须提供 AVGAS”等）。仅限美国，还可搜索导航台、定位点、地物和障碍物。
• 获取全球任意 ICAO 指定气象站最新的航空天气报告（METAR）和预报（TAF），包括原始格式和解码格式。
• 查找距离指定位置最近的 ICAO 指定气象站，或查找该位置指定范围内的多个气象站。
• 根据测得的温度和气压（来自 METAR），计算与航空相关的大气参数随高度的变化。
• 计算指定起点和终点机场之间的目视飞行规则（VFR）航线，并可选添加最多 10 个中间航路点（非直飞时）。
• 自动计算风修正（使用航线沿途最新的 METAR，并假设根据 METAR 测得的 10m AGL 风速按幂律外推至高空风）、磁偏角和日照情况（例如各航路点的日间、曙暮光或夜间状况，以及相对于飞行航迹的太阳方向〔方位角和天顶角〕，用于评估是否会受到眩光影响）。
• 提供起飞机场和出发机场每条跑道的关键信息（道面、尺寸），以及侧风和顶风／顺风分量（根据最新 METAR 计算）；在信息可用时，还会提供跑道灯光、目视进近助航设施和仪表进近助航设施的详情。
• 还会提供起飞机场和出发机场的通信频率；在信息可用时，也会提供联系电话、开放时间以及是否需要事先许可（PPR）。
• 利用当前大气条件（来自最新 METAR 数据）对大气及其相对于国际标准大气的偏差进行建模，以计算例如出发机场的密度高度、真空速（TAS）、马赫数、沿途的估计云底高度和冰点高度，以及各航路点的气压高度（即高度计设为标准气压时显示的高度，可用于确定飞行高度层）。
• 所有导航时间均以 UTC 和当地时间显示（考虑时区和夏令时调整）。除提供航线摘要（总距离、飞行时间、燃油消耗）外，还会逐航段提供所有相关数据，方便生成导航记录单（例如地速、距离、时间、磁航向和真航迹、燃油用量等）。
• 可指定飞机性能和航线剖面数据（指示空速、高度、燃油流量）；若未指定，则使用默认值（100kts、2500ft、8 USgal/hour）。
• 提供各航路点最新的 METAR（当前天气）和 TAF（预报）。
• 还会提供一个 URL，可通过任意网页浏览器在 skyvector.com 上查看航线。之后可将航线导出到 Garmin Pilot、ForeFlight 等常用飞行员应用。

### 使用这些工具的 LLM 提示词示例：

“英国 Prestwick Airport 和 Goodwood Airfield 之间的大圆距离是多少？”

“从 EGNS 沿真航向 335 度飞行 25 海里，到达的位置的纬度和经度是多少？”

“从英国 Daventry VOR（DTY）沿磁航向 85 度飞行 45 海里，到达的位置的纬度和经度是多少？”

“距离英国 Wolverhampton Airport 最近的 METAR 报告是什么？”

“计算从英国 Wolverhampton Airport 飞往 EGTK 的 VFR 航线，途中设置一个航路点，位于从 Wolverhampton 沿磁航向 210 度飞行 15 海里处。指示空速为 95 kts，高度为 2000 ft，于 45 分钟后从 Wolverhampton 起飞。请提供导航日志的详细信息以及 skyvector URL。”

然后， “从 EGTK 到 Chipping Norton 开车需要多长时间？”

“计算从加利福尼亚州 Palo Alto Airport 飞往加利福尼亚州 Half Moon Bay airport 的 VFR 航线，途中设置一个飞越 Stanford University 的航路点。指示空速为 100 kts，高度为 3000 ft，于两小时后从 Palo Alto 起飞。请提供导航日志的详细信息以及 skyvector URL。”

然后， “Half Moon Bay airport 周边 10 英里内有墨西哥餐厅吗？”

请注意，以下两个示例中的跨水航线均有限制。

“请为本周从 Liverpool 起飞、最终目的地为 Dublin 的航班提供一份 VFR 飞行计划。请确保所有航路点均有 AVGAS，并提供每个航路点 5 英里半径内的 3 处过夜住宿。请确保跨水距离不超过 50 海里。飞机为小型单发 Cessna。请将最高飞行高度限制在 8000ft 以下。请确保在每个航路点和最终目的地着陆时至少还有 1 小时日照。请提供最佳飞行行程，以尽量缩短飞行时间和总旅行时长。请检查沿途天气状况，以确保安全满足飞行限制。我必须在 12 月 31 日下午 2 点前抵达 Dublin。另请提供 skyvector URL。”

输出（PDF 转录）

“请为一架航程仅为 300nm 的小型 Cessna 制定一份仅限 VFR 的飞行计划，明天早晨从加利福尼亚州 Yucca Valley 起飞，最终目的地为 MIA，只在提供 AVGAS 的机场降落。避免超过 50nm 的跨水航线。最高飞行高度为 9000ft。要求在任何航路点（包括目的地）着陆时，当天至少还剩 1 小时日照。列出任何航路点 5 英里半径内至少 3 处可用住宿。提供详细行程，以尽量缩短总旅行时间。包含 skyvector URL。”

输出（PDF 转录）

如需更深入地了解 teckel Navigation Toolkit 的历史，请参阅这篇博客文章

如何使用 teckel Toolkits

首先下载并安装 teckel App。

接下来，使用 teckel App 生成 API 密钥。

请执行以下操作：

1. 在 App 主屏幕右上角点击钱包图标，进入 Accounts 页面。然后，在 Accounts 页面中点击“Manage API Key”，为已创建或导入的 Ethereum Account 打开 API Key Manager。

2. 调用端点时使用 API 密钥。所有可用端点都可通过 teckel App 访问，并会使用对应 Ethereum Account 的实际 API 密钥。

3. 以下示例仅作说明，我们将使用虚构密钥 d1e12345-c234-45a6-9b76-1234567891ff。请将此虚构密钥替换为你的实际 API 密钥。

接下来，选择使用 MCP 服务还是 RESTful (API) 来访问工具。

使用 MCP 服务

配置你选择的 MCP 客户端

无论使用哪种客户端，配置方式基本相同。也就是说，需要向客户端提供 MCP 服务端点和访问凭据。通常，这些内容以配置 JSON 片段的形式提供，并将你的 API 密钥用作“Authorization”标签中的“Bearer”令牌。例如，以下是用于 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 的 JSON 代码片段，展示了一个访问 teckel Ethereum 和 Navigation Toolkits MCP 服务的示例工作流。（将整个代码片段保存为 .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 服务的优势在于，连接的大模型可以解析用户提示词中的自然语言，填充调用工具箱 API 函数所需的参数，然后将返回的 JSON 结构转换为自然语言并呈现给用户。不过，如果你希望以较低层级使用 teckel 工具包（例如，在自己的 App 中），可以直接通过 RESTful (POST) API 协议调用函数。此时，你需要负责填充输入参数并处理返回的 JSON 输出。

基础 API URL 端点与 MCP 服务端点相同：

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

将所需的函数名称附加到此 URL，并将函数参数添加为查询字符串参数。teckel API 密钥必须作为 Bearer Token 添加到 Authorization 标头中。必须使用 POST 协议（而不是 GET），但请求正文可以为空，因为参数通过查询字符串传递。以下是调用 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 错误代码，用户需支付一笔基础调用费用（参见 https://teckel.io/ai-mcp-services/）。如果 API 调用因服务器错误而失败，并返回 5xx 错误代码，用户无需付费。如果该调用属于一系列嵌套调用，则以上规则适用于“外层”调用：换句话说，如果外层调用返回 4xx 错误代码而失败，用户需支付一笔基础调用费用（用于失败的外层调用），所有级联调用（无论成功与否）均不收费。同样，如果外层调用返回 5xx 错误代码而失败，用户无需支付任何费用（即使级联调用成功）。

关于 API 密钥安全的说明

如果您担心自己的 API 密钥已遭泄露（有人可能正在使用您的密钥消耗 teckel 积分），只需在 teckel App 中通过 API Key Manager → Replace API key 更换密钥。旧密钥随即会被禁用。