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 构建，list_tools 返回 55 个工具 —— 52 个核心工具来自 tronlink-mcp-core，3 个钱包管理工具由本服务器的 src/wallet-tools.ts 注册——跨两种互补操作模式。

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

架构设计

flowchart TD
  Agent["AI 代理<br/>(Claude Desktop / Claude Code)"]
  Server["TronLink MCP 服务器"]
  PW["Playwright 模式<br/>TronLinkSessionManager<br/>(浏览器自动化 + 扩展 UI 控制)"]
  API["Direct API 模式"]
  OnChain["TronLinkOnChainCapability (14 个工具)"]
  Multi["TronLinkMultiSigCapability (5 个工具)"]
  GasFree["TronLinkGasFreeCapability (3 个工具)"]
  Util["实用能力<br/>Build · StateSnapshot · TRON Crypto"]
  Flow["Flow Recipes<br/>(32 个内置流程配方)"]
  Ext["TronGrid API / 多签服务 / GasFree 服务"]
  Chain["TRON 区块链"]
  Agent -- "MCP 协议 — stdio / JSON-RPC 2.0" --> Server
  Server --> PW
  Server --> API
  Server --> Util
  Server --> Flow
  API --> OnChain
  API --> Multi
  API --> GasFree
  PW --> Ext
  OnChain --> Ext
  Multi --> Ext
  GasFree --> Ext
  Ext --> Chain

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

双模运行机制

模式一：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 等。

"27" 的算法是 52 个核心工具 − 22 个 chain/multisig/gasfree − 3 个模式无关（run_steps、list_flows、set_context） = 27。tl_clipboard、tl_keyboard、tl_scroll 等是 Playwright 模式的 UI 工具，计入 27。

模式二：Direct API + 钱包管理

直接调用 TronGrid / 多签 / GasFree REST API——无需浏览器。适用于 账户查询、转账、兑换、质押、多签管理以及运行时钱包热切换。

28 个工具 = 22 个模式二 API 工具（来自 core） + 3 个模式无关核心工具 + 3 个钱包管理工具（来自本服务器）。分组：

为什么这里的分组与架构图不同。 架构图节点只列了能力类（OnChainCapability、MultiSigCapability、GasFreeCapability），钱包管理在能力接口之外——它由 src/wallet-tools.ts 注册，并通过 src/index.ts 中的 onWalletSwap 回调向运行中的能力实例热切换钱包。

核心组件

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() — 从本地加密的 agent-wallet 读取 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. 钱包管理（3 个工具）

通过 @bankofai/agent-wallet 进行运行时钱包管理（加密 local_secure 存储）：

• tl_wallet_list — 列出所有钱包及其 ID、类型、活跃状态和 TRON 地址
• tl_wallet_create — 自动生成加密钱包并绑定到当前 MCP 会话
• tl_wallet_set_active — 按 ID 切换活跃钱包（热切换到所有能力）

如果启动时没有钱包，服务器会提示两条路径：调用 tl_wallet_create 自动生成，或通过 CLI 手动创建后设置 AGENT_WALLET_PASSWORD。 自动创建这条路径会生成随机密码，把密码保存到 ~/.agent-wallet/runtime_secrets.json，创建一个加密的 main 钱包，并让当前会话立即可用。

6. TRON 密码学工具

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

signTransaction()          raw_data_hex → 65 字节签名（通过 agent-wallet）
base58CheckEncode()        有效载荷 → base58check 编码地址
base58CheckDecode()        TRON 地址 → 21 字节有效载荷
addressToHex()             T 地址 → 0x41... 十六进制
hexToAddress()             0x41... → T 地址

使用 @noble/curves（secp256k1 ECDSA）和 @noble/hashes（Keccak-256、SHA256）。私钥不会暴露——所有签名均通过加密的 agent-wallet 完成。

Flow Recipes（32 个内置流程）

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

Playwright 流程

链上流程（11 个）

多签流程（6 个）

GasFree 流程（3 个）

配置说明

环境变量

Playwright 模式：

TronGrid API：

钱包（agent-wallet）：

多签服务：

GasFree 服务：

集成方式

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

Claude Code 自动检测：

{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": ".",
      "env": {
        "TL_TRONGRID_URL": "https://nile.trongrid.io"
      }
    }
  }
}

如果本地还没有钱包，服务启动后会提示两条路径：

1. 自动创建：调用 tl_wallet_create
2. 手动创建：
3. 运行 agent-wallet start local_secure --generate --wallet-id main
4. 把 AGENT_WALLET_PASSWORD 写进 .mcp.json
5. 重启 MCP 服务

如果选择自动创建，服务会生成随机密码，把密码保存到 ~/.agent-wallet/runtime_secrets.json，创建一个加密的 main 钱包，并继续当前会话。

如果你想直接照着一个更完整的 Nile 示例来配，可以在这个最小示例的基础上补成下面这样：

{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": ".",
      "env": {
        "TRONLINK_EXTENSION_PATH": "/path/to/tronlink-extension/dist",
        "TL_MODE": "prod",
        "TL_HEADLESS": "false",
        "TL_TRONGRID_URL": "https://nile.trongrid.io",
        "AGENT_WALLET_PASSWORD": "your-wallet-password",
        "TL_SUNSWAP_ROUTER": "TKzxdSv2FZKQrEqkKVgp5DcwEXBEKMg2Ax",
        "TL_SUNSWAP_V3_ROUTER": "TB6xBCixqRPUSKiXb45ky1GhChFJ7qrfFj",
        "TL_MULTISIG_BASE_URL": "https://apinile.walletadapter.org",
        "TL_MULTISIG_SECRET_ID": "TEST",
        "TL_MULTISIG_SECRET_KEY": "TESTTESTTEST",
        "TL_MULTISIG_CHANNEL": "test",
        "TL_GASFREE_BASE_URL": "https://open-test.gasfree.io/nile/",
        "TL_GASFREE_API_KEY": "your_gasfree_api_key",
        "TL_GASFREE_API_SECRET": "your_gasfree_api_secret"
      }
    }
  }
}

如果你只需要直接 API 工具，不需要浏览器自动化，也可以保留同样的结构，只去掉 Playwright 相关字段：

{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": ".",
      "env": {
        "TL_TRONGRID_URL": "https://nile.trongrid.io",
        "AGENT_WALLET_PASSWORD": "your-wallet-password",
        "TL_MULTISIG_BASE_URL": "https://apinile.walletadapter.org",
        "TL_MULTISIG_SECRET_ID": "TEST",
        "TL_MULTISIG_SECRET_KEY": "TESTTESTTEST",
        "TL_MULTISIG_CHANNEL": "test",
        "TL_GASFREE_BASE_URL": "https://open-test.gasfree.io/nile/",
        "TL_GASFREE_API_KEY": "your_gasfree_api_key",
        "TL_GASFREE_API_SECRET": "your_gasfree_api_secret"
      }
    }
  }
}

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                    # 服务入口、配置、能力注册
│   ├── wallet.ts                   # 统一钱包入口（agent-wallet、加密钱包、引导创建）
│   ├── wallet-tools.ts             # 钱包管理工具（list / create / set_active）
│   ├── 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 个配方）
│       ├── 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

依赖项

锁定到 mcp-server-tronlink@0.1.1 的 package.json。升级钱包、MCP 或密码学库 major 版本时务必重新核对。

工具契约与副作用

输入/输出 schema 与错误契约。 每个工具的输入/输出 schema 及结构化错误信封由底层框架定义——见 TronLink MCP Core 的 SSOT 错误码表（code / retryable / hint / 典型触发）。每个响应均带 meta.schemaVersion，major 版本内字段含义稳定。Agent 应基于 error.code 与 error.retryable 分支，不要解析人类可读的 message。

逐工具输入 schema 可在运行时发现。 每个工具的参数都由 core 用 Zod 校验,并通过 MCP list_tools 方法以 JSON inputSchema 形式暴露,因此客户端无需阅读本页即可枚举参数名、类型和必填项。下方表格按能力归纳工具;list_tools 才是权威的机器可读来源。

副作用分级。 调用前先分类；对结果未知的写操作绝不自动重试。

• 预检查： 所有交易类工具在执行前会校验（余额、回滚、资源消耗）。
• 人工确认（HITL）： 写操作工具使用加密的本地 agent-wallet 签名；浏览器模式下由用户在 TronLink UI 审批。生产环境应将每个「远程写」工具视为需要确认。
• 重试： 只读工具可安全重试；「远程写」工具除非证明幂等，否则不得自动重试。

精选工具 schema（文档侧镜像）

以下是最关键工具输入的文档侧镜像——当 agent 需要在没有打开 MCP 会话的情况下写工具调用站点时使用。运行时 list_tools 仍是权威源：那里有完整的 Zod 元信息（描述、default 等）以及 meta.schemaVersion。下方字段抄自 @tronlink/tronlink-mcp-core src/mcp-server/schemas.ts，遵循 JSON Schema Draft 7。未镜像全部 52 个工具——以 core 仓库为 SSOT。

平价由 CI 强制。 scripts/check_doc_schema_parity.py（在 push、PR 及每日定时通过 check-doc-schema-parity.yml 触发）会对下方每个块的顶层字段集 + required 标记与上游 schemas.ts 做 diff——上游改名或 required ↔ optional 漂移都会让 CI 失败。

tl_chain_send —— Remote Write

{
  "type": "object",
  "required": ["to", "amount"],
  "properties": {
    "to":               { "type": "string", "description": "收款方 TRON 地址（T 开头、34 字符）" },
    "amount":           { "type": "string", "description": "金额（如 TRX 用 \"1.5\"，代币用字符串数量）" },
    "token_type":       { "type": "string", "enum": ["TRX", "TRC10", "TRC20"], "description": "默认: TRX" },
    "token_id":         { "type": "string", "description": "TRC10 token ID（token_type=TRC10 时必填）" },
    "contract_address": { "type": "string", "description": "TRC20 合约地址（token_type=TRC20 时必填）" },
    "memo":             { "type": "string", "description": "可选交易备注" }
  }
}

tl_chain_swap_v3 —— Remote Write（action=execute 时）

{
  "type": "object",
  "required": ["action", "from_token", "to_token", "amount"],
  "properties": {
    "action":           { "type": "string", "enum": ["estimate", "execute"], "description": "estimate = 仅报价（Network Read）；execute = 签名 + 广播（Remote Write）" },
    "from_token":       { "type": "string", "description": "源代币地址，或 'TRX' 表示原生 TRX" },
    "to_token":         { "type": "string", "description": "目标代币地址，或 'TRX'" },
    "amount":           { "type": "string", "description": "输入金额（代币单位）" },
    "fee_tier":         { "type": "number", "enum": [500, 3000, 10000], "description": "池费率 bps：500=0.05%、3000=0.3%、10000=1%（默认 3000）" },
    "slippage":         { "type": "number", "description": "滑点容忍百分比（默认 0.5）。详见上方“兑换安全”——生产环境绝不允许未声明默认值。" },
    "sqrt_price_limit": { "type": "string", "description": "可选 partial-fill 价格上限（进阶）" }
  }
}

tl_chain_stake —— Remote Write

{
  "type": "object",
  "required": ["action", "amount_trx"],
  "properties": {
    "action":     { "type": "string", "enum": ["freeze", "unfreeze"], "description": "freeze 锁定 TRX 换资源；unfreeze 开始 14 天解冻倒计时" },
    "amount_trx": { "type": "number", "description": "冻结 / 解冻的 TRX 数量" },
    "resource":   { "type": "string", "enum": ["BANDWIDTH", "ENERGY"], "description": "资源类型（默认 BANDWIDTH）" }
  }
}

tl_multisig_submit_tx —— Remote Write

{
  "type": "object",
  "required": ["address", "transaction"],
  "properties": {
    "address":           { "type": "string", "description": "提交此交易的签名方地址" },
    "function_selector": { "type": "string", "description": "如 'transfer(address,uint256)'（可选）" },
    "expire_time":       { "type": "number", "description": "过期时间戳，毫秒（默认: 当前时间 + 24h）" },
    "transaction":       { "type": "object", "description": "已签名交易 { raw_data, signature[] }；contract 条目可携带 Permission_id" }
  }
}

完整 transaction 结构（raw_data → contract[] → parameter 等）见 tronlink-mcp-core schemas.ts——过长不在此处镜像。

tl_gasfree_send —— Remote Write

{
  "type": "object",
  "required": ["to", "amount", "contract_address"],
  "properties": {
    "to":               { "type": "string", "description": "收款 TRON 地址" },
    "amount":           { "type": "string", "description": "代币数量（代币单位，如 '10.5'）" },
    "contract_address": { "type": "string", "description": "TRC20 代币合约地址" }
  }
}

tl_chain_get_account —— Network Read

{
  "type": "object",
  "properties": {
    "address": { "type": "string", "description": "查询的 TRON 地址（默认：当前配置钱包）" }
  }
}

tl_evaluate —— High-risk / Destructive（仅 Playwright 模式）

{
  "type": "object",
  "required": ["script"],
  "properties": {
    "script":  { "type": "string", "description": "在受控浏览器页面上下文中执行的 JS 表达式；返回值会被序列化。" },
    "timeout": { "type": "number", "description": "超时毫秒数（默认 30000）" }
  }
}

提醒：tl_evaluate 在受控 Playwright 浏览器中执行任意 JS。严格不需要时请从 MCP host 白名单中禁用（见下方“安全模型”）。

安全模型

安全边界

兑换安全（tl_chain_swap / tl_chain_swap_v3）

兑换属于 远程写，且对接公开 DEX 路由器，因此暴露在 价格滑点 与 三明治攻击 / MEV 之下：在报价和执行之间池子价格变动时，实际成交可能比报价更差。

• 必须设置 minOut / 滑点上限。 通过 list_tools 查看 tl_chain_swap_v3 的输入 schema（SwapV3Params），核对实际的 minimum-output / 滑点字段名；不要依赖未声明的默认值，缺省或 0 的 minOut 一律视为不安全。
• 执行前现取报价。 通过 Skills tron-swap 的 swap-quote / swap-route（或同等接口）取最新报价/路径，选定可接受的滑点容忍度并显式传入。
• 钉死 router。 TL_SUNSWAP_V3_ROUTER 没有内置默认值；过期或错误的 router 会把资金路由到非预期目标。请按当前 SunSwap V3 router 地址设置（见环境变量）。
• 不可自动重试。 swap 失败或结果未知都属于远程写——先在链上确认再决定是否重发（TL_CHAIN_SWAP_FAILED 不可重试）。

多签凭证管理（TL_MULTISIG_SECRET_ID / TL_MULTISIG_SECRET_KEY）

这是多签服务的 HMAC-SHA256 API 凭证（不是链上私钥），但它们授权交易提交——必须按 secret 对待。

• 按环境隔离。 Mainnet 与测试网必须使用不同凭证，按项目 / 渠道（TL_MULTISIG_CHANNEL）分别申请。绝不在测试或预发 MCP host 中复用 Mainnet 凭证。
• 存储。 放进 host 的 secret manager / env，不要写进会提交 git 的 .mcp.json（参见上面的 token passthrough 边界）。
• 轮换。 周期性轮换 TL_MULTISIG_SECRET_KEY；如果 host 或日志可能记录过，立刻轮换。server 在启动时读取凭证，所以本侧轮换 = 更新 env + 重启 server；凭证本身的颁发 / 撤销在多签服务控制台完成。
• 撤销。 一旦怀疑泄漏，先在服务侧吊销该凭证，再轮换到新值后再开始下一次签名会话——曝光的凭证可让攻击者直接向多签队列提交交易。
• 最小权限。 每条凭证只授予所需的 channel / project；不要在多个无关 agent 间共享同一凭证。

禁用 tl_evaluate

如果你的工作流不需要在受控浏览器里执行任意 JS，请显式从工具面上撤下。各 host 的配置 key 不同：

// Claude Code —— .claude/settings.json（项目级）或 ~/.claude/settings.json（用户级）
{
  "permissions": {
    "deny": ["mcp__tronlink__tl_evaluate"]
  }
}

// Claude Desktop —— claude_desktop_config.json
{
  "mcpServers": {
    "tronlink": {
      "command": "node",
      "args": ["dist/index.js"],
      "disabledTools": ["tl_evaluate"]
    }
  }
}

// 通用 MCP 客户端：在客户端侧用 list_tools 过滤——
// 把 server 暴露的工具列表里 name 等于 "tl_evaluate" 的项剔除，再交给模型。

重启后用 list_tools 验证：tl_evaluate 应当不再出现。同一套模式也适用于 tl_seed_contract / tl_seed_contracts（仅 e2e 的合约部署工具）。

钱包密钥存储

Direct-API 路径使用 @bankofai/agent-wallet 管理的本地加密钱包签名。解锁这把钱包有两条路径，请按目的明确选择。

路径 A — 手动（生产推荐）。 离线创建钱包，将 AGENT_WALLET_PASSWORD 放进 MCP host 的 secret manager，再启动 server。密码仅存在于进程内存，server 不写任何文件。

路径 B — 自动创建（仅适合本地开发）。 启动时若无钱包且 agent 调用了 tl_wallet_create，server 将：

1. 生成随机密码。
2. 将密码以明文写入 ~/.agent-wallet/runtime_secrets.json，以便重启后能复用同一钱包。
3. 在 ~/.agent-wallet/ 创建加密的 main 钱包（可用 AGENT_WALLET_DIR 覆盖目录）。

生产建议。

• 优先路径 A。AGENT_WALLET_PASSWORD 来自 host 的 secret manager（Claude Desktop env、vault 等）。
• 必须用路径 B 时（如临时 CI），把 AGENT_WALLET_DIR 指到任务结束即销毁的 tmpfs。
• 涉及真实资金的工具，生产环境优先选 mcp-tronlink-signer（浏览器审批、不落盘密码），避免 Direct-API。

如何强制路径 A（文档侧的当下做法）。

1. server 启动前离线创建钱包：

   agent-wallet start local_secure --generate --wallet-id main
   # 此处输入的密码请单独保管——它是唯一的副本
   

2. 让密码通过 MCP host 的 secret manager 注入到 server 的 env：

   // .mcp.json — secret 来自 host env，而不是这个文件本身
   {
     "mcpServers": {
       "tronlink": {
         "command": "node",
         "args": ["dist/index.js"],
         "env": { "AGENT_WALLET_PASSWORD": "${AGENT_WALLET_PASSWORD}" }
       }
     }
   }
   

3. 禁止 agent 调用 tl_wallet_create。 用与 tl_evaluate 相同的方式禁用（Claude Code permissions.deny、Claude Desktop disabledTools，或客户端侧基于 list_tools 用名字 tl_wallet_create 过滤）。

4. 首次启动后验证：list_tools 中不应出现 tl_wallet_create；~/.agent-wallet/runtime_secrets.json 不存在即说明路径 B 没有走过。

待解决（代码侧）。 长期方案是在 server 启动时加 --no-auto-create / AGENT_WALLET_DISABLE_AUTOCREATE=1 开关，使无钱包时直接 fail-loud。上游 PR ship 之前，上面这套文档级强制方案是 defense-in-depth。

典型使用场景

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"

# 3. 如果本地还没有钱包，二选一：
# 方案 A：在 MCP 会话里调用 tl_wallet_create
# 方案 B：本地执行
# agent-wallet start local_secure --generate --wallet-id main
# 然后把同一个密码写进 .mcp.json 的 AGENT_WALLET_PASSWORD

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

版本与许可证

• 包： @tronlink/mcp-server-tronlink v0.1.1
• 许可证： MIT —— SPDX-License-Identifier: MIT
• 变更记录 / 发布： https://github.com/TronLink/mcp-server-tronlink/releases —— 截至当前尚无 GitHub tag 发布；1.0 之前通过 package.json 版本号迭代。打 tag 之前请直接看 commit 历史。

兼容性与迁移策略

• 语义化版本。 1.0 之前：minor 升级（0.x → 0.y）允许破坏性变更；patch 升级（0.1.x → 0.1.y）不变更工具名、输入 schema、error.code 值或 meta.schemaVersion 语义。1.0 之后：标准 semver，仅 major 允许破坏。
• 稳定契约（patch 不会动）：
  • 工具名（tl_chain_send、tl_chain_swap_v3、tl_multisig_*、tl_gasfree_*、tl_evaluate 等）
  • error.code 枚举（SSOT：TronLink MCP Core 错误码）
  • error.retryable 语义
  • meta.schemaVersion 的 major 分量
  • 必需环境变量名（TL_TRONGRID_URL、TL_MULTISIG_SECRET_KEY、AGENT_WALLET_PASSWORD 等）
• 不稳定契约（随时可能变化）：
  • message 自然语言文本、日志行格式、stderr 输出
  • 内部 Knowledge Store key（消费者不应解析）
  • 预检查的错误 detail 文本（分支用 code，别用 details.reason）
• 废弃窗口。 工具或入参字段被废弃时，下一 minor 至少保留旧形式与新形式并存 一个 minor 周期，list_tools 会带 meta.deprecated 标记；移除最早在再下一周期。
• 升级后校验。 重新 list_tools 确认依赖的工具名 + inputSchema 仍在，再继续工作流；将 meta.schemaVersion 与会话开始时缓存的值对比。