MCP Server TronLink

概述

GitHub: https://github.com/TronLink/mcp-server-tronlink

mcp-server-tronlink 是一个生产级的 Model Context Protocol (MCP) 服务器，使 AI 代理（Claude、GPT 等）能够通过自然语言与 TRON 区块链交互。基于 @tronlink/tronlink-mcp-core 构建，提供跨两种互补操作模式的 56+ 工具。

核心亮点： - 双模架构：Playwright（浏览器自动化）+ Direct API（链上操作） - 32 个内置 Flow Recipe，带预检查和依赖解析 - 基于 @noble/curves 的非托管本地交易签名 - 多签管理，支持实时 WebSocket 监控 - 通过 GasFree 服务集成实现零 Gas TRC20 转账

架构设计

AI 代理 (Claude Desktop / Claude Code)
         | (MCP 协议 — stdio / JSON-RPC 2.0)
         v
TronLink MCP 服务器
├── Playwright 模式 ─── TronLinkSessionManager
│   └── 浏览器自动化 + TronLink 扩展 UI 控制
├── Direct API 模式
│   ├── TronLinkOnChainCapability   (14 个工具)
│   ├── TronLinkMultiSigCapability  (5 个工具)
│   └── TronLinkGasFreeCapability   (3 个工具)
├── 实用能力
│   ├── TronLinkBuildCapability     (扩展构建)
│   ├── TronLinkStateSnapshotCapability (UI 状态提取)
│   └── TRON Crypto Utils           (地址派生、签名、Base58)
└── Flow Recipes (32 个内置流程配方)
         |
         v
TronGrid API / 多签服务 / GasFree 服务
         |
         v
TRON 区块链

两种模式可同时运行，工具根据配置自动启用。

双模运行机制

模式一：Playwright（浏览器自动化）

通过 Playwright Chromium 控制 TronLink Chrome 扩展。适用于 E2E 测试、UI 验证和 DApp 交互。

能力： - 使用 --load-extension 标志启动浏览器加载 TronLink - 从 Chrome API 自动检测扩展 ID - 多标签页跟踪，自动角色分类（扩展 / 通知 / DApp / 其他） - 基于 DOM 的状态提取（TRON 地址、TRX 余额、网络检测） - Base64 编码的截图捕获 - 自动处理浏览器对话框（alert、confirm、prompt）

27 个 Playwright 工具包括： tl_launch、tl_cleanup、tl_navigate、tl_click、tl_type、tl_screenshot、tl_accessibility_snapshot、tl_describe_screen 等。

模式二：Direct API（链上操作）

直接调用 TronGrid REST API——无需浏览器。适用于 账户查询、转账、兑换、质押和多签管理。

22 个 API 工具分组：

核心组件

1. TronLinkSessionManager

完整的浏览器生命周期管理：

页面检测： 自动检测 15 种 TronLink 界面：home、login、settings、send、receive、sign、broadcast、assets、address_book、node_management、dapp_list、create_wallet、import_wallet、notification、unknown。

2. TronLinkOnChainCapability（14 个工具）

TronGrid 的直接 API 封装：

查询操作： - getAddress() — 从配置的私钥派生 TRON 地址 - getAccount() — 余额、带宽、能量、权限 - getTokens() — TRC10 和 TRC20 代币余额 - getTransaction() — 按 txID 获取交易详情 - getHistory() — 分页查询交易历史 - getStakingInfo() — 质押状态（冻结金额、投票、解冻）

交易操作： - send() — 转账 TRX、TRC10 或 TRC20 代币 - stake() — 冻结/解冻 TRX 获取带宽或能量（Stake 2.0） - resource() — 代理/取消代理带宽或能量 - swap() — 通过 SunSwap V2 代币兑换 - swapV3() — 通过 SunSwap V3 智能路由代币兑换

多签操作： - setupMultisig() — 配置多签权限 - createMultisigTx() — 创建未签名的多签交易 - signMultisigTx() — 签署多签交易

3. TronLinkMultiSigCapability（5 个工具）

TRON 多签服务的 REST + WebSocket API：

• queryAuth() — 查询多签权限（所有者/活跃权限、阈值、权重）
• submitTransaction() — 提交签名交易（达到阈值时自动广播）
• queryTransactionList() — 带过滤条件的交易列表
• connectWebSocket() — 实时交易监控
• disconnectWebSocket() — 停止监控

实现细节： HmacSHA256 签名生成用于 API 认证，基于 UUID 的请求签名，同时支持 Nile 测试网和主网凭证。

4. TronLinkGasFreeCapability（3 个工具）

通过 GasFree 服务实现零 Gas TRC20 转账：

• getAccount() — 查询资格、支持的代币、每日配额
• getTransactions() — 查询免 Gas 交易历史
• send() — 零 Gas 费发送 TRC20

5. TRON 密码学工具

纯密码学函数——无外部服务调用：

privateKeyToAddress()      64 字符十六进制 → TRON 地址（base58 + hex）
signTransaction()          raw_data_hex → 65 字节签名
base58CheckEncode()        有效载荷 → base58check 编码地址
base58CheckDecode()        TRON 地址 → 21 字节有效载荷
addressToHex()             T 地址 → 0x41... 十六进制
hexToAddress()             0x41... → T 地址

使用 @noble/curves（secp256k1 ECDSA）和 @noble/hashes（Keccak-256、SHA256）。

Flow Recipes（32 个内置流程）

预配置的多步骤工作流，带依赖检查和参数模板。

Playwright 流程

链上流程（11 个）

多签流程（6 个）

GasFree 流程（3 个）

配置说明

环境变量

Playwright 模式：

TronGrid API：

多签服务：

GasFree 服务：

集成方式

1. 项目级 MCP 配置（.mcp.json）

Claude Code 自动检测：

{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "TL_TRONGRID_URL": "https://nile.trongrid.io",
        "TL_CHAIN_PRIVATE_KEY": "你的64字符十六进制私钥"
      }
    }
  }
}

2. Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json。

3. Claude Code 全局设置

编辑 ~/.claude/settings.json 或 .claude/settings.json。

4. 任意 MCP 客户端

支持 stdio 传输协议——兼容任何符合 MCP 标准的客户端。

项目结构

mcp-server-tronlink/
├── src/
│   ├── index.ts                    # 服务入口、配置、能力注册
│   ├── session-manager.ts          # 浏览器生命周期（TronLinkSessionManager）
│   ├── capabilities/
│   │   ├── on-chain.ts             # 14 个链上操作（TronGrid）
│   │   ├── multisig.ts             # 5 个多签操作（REST + WS）
│   │   ├── gasfree.ts              # 3 个免 Gas 转账操作
│   │   ├── build.ts                # 扩展 webpack 构建
│   │   ├── state-snapshot.ts       # UI 状态提取
│   │   └── tron-crypto.ts          # 地址派生、签名、Base58
│   └── flows/
│       ├── index.ts                # 流程注册（32 个配方）
│       ├── import-wallet.ts        # 钱包导入流程
│       ├── switch-network.ts       # 网络切换流程
│       ├── transfer-trx.ts         # 转账流程
│       ├── multisig.ts             # 6 个多签流程
│       ├── onchain.ts              # 11 个链上流程
│       └── gasfree.ts              # 3 个免 Gas 流程
├── dist/                           # 编译输出
├── .mcp.json                       # MCP 配置
├── .env.example                    # 环境变量参考
├── package.json
├── tsconfig.json
└── README.md

依赖项

安全模型

典型使用场景

1. 钱包自动化 — 导入钱包、查询余额、发起转账
2. DApp 测试 — 启动浏览器、连接钱包、签署交易、验证状态
3. 链上交易 — 直接 API 兑换、质押、无需浏览器的代币转账
4. 多签工作流 — 设置权限、提交/监控交易
5. 免 Gas 操作 — 无需 TRX 余额即可完成 TRC20 转账
6. 基础设施测试 — 合约部署、固件管理、Mock 服务

快速开始

# 1. 构建
npm install && npm run build

# 2. 配置（Nile 测试网示例）
export TL_TRONGRID_URL="https://nile.trongrid.io"
export TL_CHAIN_PRIVATE_KEY="你的64字符十六进制私钥"

# 3. 配合 Claude Code 使用
# 添加到 .mcp.json 后自然语言使用：
# "查看我的 TRX 余额"
# "给 TAddress... 转 10 个 TRX"
# "在 SunSwap V3 上用 100 TRX 兑换 USDT"