mcp-tronlink-signer

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

将 tronlink-signer 封装为 MCP 工具的服务器，供 Claude 及其他 AI 客户端使用。通过 TronLink 浏览器钱包对 TRON 交易进行签名，需用户在浏览器中授权确认 — 私钥始终留在钱包中，不会对外暴露。

配置

Claude Code

claude mcp add -s user tronlink-signer -- npx mcp-tronlink-signer

Claude Desktop / Cursor

{
  "mcpServers": {
    "tronlink-signer": {
      "command": "npx",
      "args": ["mcp-tronlink-signer"]
    }
  }
}

从源码构建

git clone https://github.com/TronLink/mcp-tronlink-signer.git
cd mcp-tronlink-signer
pnpm install && pnpm build

然后指向构建产物：

claude mcp add -s user tronlink-signer -- node /path/to/packages/mcp-tronlink-signer/dist/cli.js

MCP 工具

所有工具均支持可选的 network 参数（mainnet / nile / shasta），默认使用 mainnet。

人工确认（HITL）。 所有涉及签名的工具（send_trx、send_trc20、sign_message、sign_typed_data、sign_transaction）都会打开 TronLink 浏览器审批页。AI agent 无法在用户点击 Approve 之前签名。生产环境必须把 Remote Write 工具视为需要确认。

MCP 资源

MCP 提示词

工作原理

1. AI 智能体调用 MCP 工具（如 send_trx）— CLI 中会显示签名提示
2. 服务器将请求委托给 tronlink-signer，后者打开单个浏览器标签页用于授权（如已打开则复用现有标签）
3. 授权页面通过 TIP-6963 协议发现 TronLink 钱包
4. 自动解锁钱包，并在需要时切换网络
5. 如果钱包已连接，connect_wallet 会自动完成
6. 交易详情会被解析为人类可读的格式（TRX 转账、TRC20、TRC721 NFT、质押、委托、投票等）
7. 用户在浏览器中查看并批准
8. TronLink 完成交易签名 — 私钥始终留在钱包中
9. 结果返回给 AI 智能体 — 页面保持打开以便处理下一次操作

端到端示例

一个典型的 send_trx 流程，从用户提问到链上结果：

1. 用户 → 智能体

「在 nile 上给 TJRabc…xyz 转 5 个 TRX。」

2. 智能体 → MCP 工具调用

{
  "name": "send_trx",
  "arguments": { "to": "TJRabc...xyz", "amount": 5, "network": "nile" }
}

3. 审批（人工确认 HITL） —— 服务打开 TronLink 审批页;用户核对「Send 5 TRX → TJRabc…xyz (Nile)」后点击 Approve。若点击 Reject 则返回错误结果 Error: USER_REJECTED（未经用户同意不要重发）。

4. MCP 工具 → 智能体（结果）

{
  "txId": "0a1b2c...",
  "status": "success"
}

5. 智能体 → 用户

「已发送 5 TRX——链上已确认（交易 0a1b2c…）。」

请基于 isError 与 JSON 结果中的 status 分支；错误只有消息文本（见错误）。status: "pending" 表示广播成功但确认超时——应用 get_balance 或浏览器查询对账,而不是重发(见错误）。

取消

所有签名工具均支持 MCP 取消机制。如果 AI 客户端取消了一个待处理的工具调用（例如用户在 Claude Code 中按下 Ctrl+C），进行中的请求会被自动中止，对于已被取消的请求不会打开浏览器授权页面。

交易确认

当调用 sign_transaction 且 broadcast: true 时，服务器会在广播后自动轮询链上确认状态，并返回执行结果（success、pending 或 failed）。如果交易在链上失败（如 OUT_OF_ENERGY、Solidity revert），结果为 status: "failed"，error 中带解码后的原因，并标记 isError: true。

错误

v0.1.4 中，错误以 MCP 工具结果返回：isError: true，内容是一段文本 Error: <message>，没有结构化的 code 或 retryable 字段。已知的消息如下：

重试策略。 只读调用（get_balance）可安全重发。拒绝表示用户不同意——未经用户同意不要重发。对 send_trx、send_trc20 及 broadcast: true 的 sign_transaction，任何错误（包括 CANCELLED_BY_CALLER、TIMEOUT）都应视为结果未知，先用 get_balance 或区块浏览器确认后再考虑重发。

安全边界

环境变量

版本与许可证

• 包： mcp-tronlink-signer v0.1.4
• 许可证： MIT —— SPDX-License-Identifier: MIT
• 变更记录 / 发布： https://github.com/TronLink/mcp-tronlink-signer/releases

内联 changelog

本页是下游 README 镜像；以 GitHub releases 与各包 CHANGELOG.md 为准。下方条目只覆盖 MCP 可见面（工具、schema、安全边界），内部重构不列。

v0.1.4 (仅 npm，截至本文写就尚未在 GitHub 打 tag)

仅 patch 修复。无新工具、无破坏性输入/输出 shape 变化。升级后用 list_tools 复核。

v0.1.3 (仅 npm，截至本文写就尚未在 GitHub 打 tag)

仅 patch 修复。无新工具、无破坏性输入/输出 shape 变化。

v0.1.2 — 2026-04-15

与 tronlink-signer@0.1.2 同步发布。审批流大改版；MCP 工具 schema 无破坏性变化。

• 新增 —— sign_transaction 支持 broadcast: true 同步签名 + 广播（此前仅签名）。
• 新增 —— connect_wallet 在钱包已连接时自动完成，无需再走一次审批。
• 新增 —— 交易解析：TRX 转账、TRC10、TRC20、TRC721 NFT、质押/解冻、委托、投票等在审批页以人类可读形式呈现。
• 改进 —— 单页审批流：一个常驻浏览器标签 + 心跳检测；server 重启后旧标签自动失效。
• 改进 —— TRC20 金额校验改用 BigInt 小数转换（处理 0 位小数、>18 位小数等边界）。
• 改进 —— send_trx、sign_transaction 在提交失败时返回真实的 broadcast 错误，不再是空消息。
• 迁移 —— 无需迁移；MCP 工具 schema 未变更。

v0.1.1 — 2026-04-15

• tronlink-signer@0.1.1 + mcp-tronlink-signer@0.1.1 首次 npm 发布。
• 各包 README，含用法与 API 文档。
• npm package metadata（keywords、repository、license、files）。
• LICENSE 增加版权声明。

兼容性与迁移策略

• 语义化版本。 1.0 之前：minor 升级（0.x → 0.y）允许破坏性变更；patch 升级（0.1.x → 0.1.y）不变更 MCP 工具名或输入 schema。1.0 之后：标准 semver，仅 major 允许破坏。
• 废弃窗口。 当某工具或入参字段被废弃时，下一 minor 至少保留旧形式与新形式并存 一个 minor 周期，schema 内置 meta.deprecated 标记；移除最早发生在再下一周期。
• 稳定契约。 工具名、status 值（success / pending / failed）属于公开面，patch 不会动。
• 不稳定契约。 错误 message 文本（匹配错误中列出的已知取值，其他按未知处理）、日志行格式、审批页的视觉布局 不属于 公开面，随时可能变化。
• 升级后校验。 升级后 必须 重新 list_tools 确认你依赖的名字 + schema 仍存在，再继续工作流。