Teckel Ethereum Toolkit

以太坊工具包

此 MCP 服务可访问 teckel web3 Ethereum JSON-RPC 服务的一个子集，即那些只需读取区块链（Mainnet 和 Sepolia）的服务。

以太坊工具包的主要目的是让 LLM/AI/Agents 实时访问 Ethereum 区块链的基本信息。通过你选择的 MCP 客户端连接到 LLM 后，LLM 可以使用工具包中的一系列工具，回答如下提示词：

“Mainnet 和 Sepolia 测试网上当前的 Ethereum 价格（USD）是多少？”

“Mainnet 和 Sepolia 测试网上当前的 Ethereum Gas 价格是多少？”

“我的 Ethereum 账户在 Mainnet 和 Sepolia 测试网上的余额是多少？”

“Mainnet 和 Sepolia 测试网上最新区块中处理了哪些交易？”

如何使用 teckel 工具包

首先下载并安装 teckel App。

接下来，使用 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 服务端点和访问凭据。通常需要提供一段配置 JSON 代码片段，并将 API 密钥用作 “Authorization” 标签中的 “Bearer” 令牌。例如，以下是用于 Cursor 桌面应用的准确配置（在 Cursor 应用中前往 Cursor Settings -> Tools & MCP -> + New MCP server，并使用你的实际 teckel API 密钥替换此虚构密钥，然后输入这些详细信息）。

MCP JSON 配置（Cursor 示例）

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

注意：此配置适用于 HTTP(streamable) 协议。如果你的客户端需要较旧的（现已弃用）SSE 协议，请将 “ethereum-mcp” 替换为 “ethereum-sse”。

MCP JSON 配置（n8n 示例）

同样，对于 n8n，以下是一个示例工作流的 JSON 代码片段，该工作流会访问 teckel Ethereum 和 Navigation Toolkits MCP 服务。（将整个代码片段保存到 .json 文件中，然后将文件导入 n8n 工作流。）你需要在 n8n 中将凭据替换为自己的 “Bearer Auth” 凭据（使用你的 teckel API 密钥作为 “Bearer” 令牌）。

{
  "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 工具包（例如，在自己的应用中使用），可以直接通过 RESTful（POST）API 协议调用函数。此时，你需要负责填充输入参数并处理返回的 JSON 输出。

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

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

需要将目标函数名称附加到此 URL，并将函数参数作为查询字符串参数添加。teckel API 密钥必须作为 Bearer Token 添加到 Authorization 标头中。必须使用 POST 协议（而不是 GET），但由于参数通过查询字符串传递，因此请求正文可以留空。下面是一个 curl 请求示例，用于调用 Ethereum Toolkit 中 eth_gasPrice 方法的 perform_sun_calculations，并提供所需的 network 参数：

Curl 请求

curl -X POST \   'https://mcp-servers.bh.tkllabs.io:9780/eth_gasPrice?network=mainnet' \
  -H 'Authorization: Bearer d1e12345-c234-45a6-9b76-1234567891ff' \
  -H 'Content-Type: application/json'

JSON 响应

{"gas_price":465912773}

函数（工具）列表

工具包中提供的完整函数列表请参见 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 credits），只需在 teckel App 中通过 API Key Manager → Replace API key 更换密钥。旧密钥将立即失效。