TON MCP：首个让 AI 智能体跨链转移价值的 MCP 服务器
TONNode 是首个不止会读 TON 的 MCP：AI 智能体可以非托管地兑换资产，并跨链兑换到 6 条 EVM 网络。在 TON 上构建 DeFAI 智能体。
TON 上的 DeFAI 智能体：为什么只会读链远远不够
你的 AI 智能体能回答关于 TON 的各种问题——钱包余额、合约状态、交易历史。这时用户说：“我在 TON 上有 500 USDT，想去 Base 上建个仓。”智能体卡住了。它什么都看得见，却什么都做不了。“读区块链”和“转移价值”之间隔着一道鸿沟，普通的只读 MCP 跨不过去。只会读的智能体，本质上是一个带聊天框的仪表盘。DeFAI（DeFi + AI）真正的起点，是智能体能够转移价值，而不只是盯着它看。
第二堵墙是信任。市面上大多数“智能体钱包”都是托管式的：要让智能体能发出任何东西，就得有人替它保管私钥并签名。对一个自主运行的机器人来说，这意味着私钥或 operator 密钥躺在一个你控制不了的地方。对于要管别人钱的生产环境，这是不可接受的。
TONNode 是一个面向 TON 的 hosted MCP 服务器（官网 tonnode.io），一共提供 16 个工具：读链、兑换、跨链和钱包生成。关键在于：兑换、跨链和钱包相关的工具严格非托管。服务器从不签名、从不保管资金和私钥——它返回的是未签名的 TonConnect 消息，签名由用户自己的钱包完成。这就是不在私钥控制权上妥协的 TON 跨链 MCP。
要让“执行动作”变得安全，需要满足两点：
- 智能体负责构建交易，但不签名。 签名由用户的钱包通过 TonConnect 完成。服务器碰不到密钥。
- 智能体能跨出单条链的边界。 加密世界里的价值同时活在多条链上，“只支持 TON”只能算解决了一半问题。
TONNode 两点都做到了。下面我们看看怎么用这些工具拼出一个真正的 DeFAI 智能体。
非托管兑换：通过 Omniston 的 get_swap_quote 与 build_swap_tx
TONNode 的兑换由两个职责分离的工具组成：先报价，后构建。
get_swap_quote—— 通过 Omniston 协议获取 GRAM⇄jetton 的硬报价，该协议聚合了 STON.fi 和 DeDust 的流动性。也就是说，智能体一次就能拿到两大 DEX 中更优的价格，而不用去猜哪边更划算。build_swap_tx—— 构建一笔未签名的兑换交易，可直接交给 TonConnect。非托管的精髓正在这一步：服务器只交出消息，签名的是用户自己的钱包。
打个简单的比方：get_swap_quote 是兑换点柜台上的牌价，build_swap_tx 是一张填好的兑换单，你自己过目、自己签字。柜员（服务器）不会伸手进你的钱包。
在与智能体的对话里，它长这样：
用户：把 100 GRAM 换成 USDT，确认前先给我看汇率
智能体 → get_swap_quote (GRAM → USDT, 100)
智能体：你将收到 ≈ X USDT，汇率 Y（Omniston 路由）。要构建交易吗？
用户：好
智能体 → build_swap_tx
智能体：搞定，去钱包里签名 ↓（TonConnect）
有一个对金额正确性至关重要的细节：jetton 以 raw 单位存储，换算取决于 decimals。USDT 的 decimals = 6，而大多数 jetton 是 9。在展示任何余额或金额之前，智能体必须先调用 get_jetton_info（jetton 元数据：名称、符号、decimals、发行量）和 get_jetton_balance（jetton 余额；jetton 钱包地址在链上推导）。否则智能体会给用户显示“50000000”，而不是“50”。
在整个流程的任何一步，密钥都不会离开用户的设备。这套方案的详细拆解见面向智能体的非托管兑换。
TON 的跨链 MCP：原子化 HTLC 锁定与通往 6 条 EVM 网络的路径
接下来是其他任何 TON MCP 都没有的能力：从 TON 到 EVM 网络的跨链兑换，且不依赖托管型跨链桥。TONNode 通过原子化 HTLC 锁定合约（Hashed TimeLock Contract）实现这一点。
机制类似一个装了两把锁的保险柜交易：
- 资金在两条链上的锁定合约中被同一个秘密值的哈希锁住。
- 秘密值未披露之前，钱哪儿也去不了。
- 披露秘密值会同时解锁两边——要么交易整体完成，要么整体不发生。不存在“钱出去了却没回来”的中间态。
- 如果对手方掉链子——超时后资金自动退回原主。
支持的网络就是以下这些，且 TON 永远是源链：
- Ethereum
- Arbitrum
- Base
- BNB Chain
- Polygon
- Avalanche
目前不支持 TRON——这一点必须如实告诉用户，别让智能体许下做不到的承诺。
这里非托管的关键点在于：build_crosschain_swap_tx 同时返回未签名的 HTLC 锁定交易和秘密值——秘密值留在用户/智能体手里，而不是留在服务器上。披露秘密值是一个独立的显式步骤，且必须在链上确认就绪之后进行。完整的机制拆解见TON → Ethereum 跨链兑换一文。
跨链五件套：报价、构建、追踪、披露、退款
一笔跨链交易不是一个按钮，而是一台状态机。每个状态都对应一个专属工具：
get_crosschain_quote—— 跨链兑换报价：用户在目标网络能收到多少、手续费、路由。build_crosschain_swap_tx—— 未签名的 HTLC 锁定交易 + 秘密值。交易由用户的钱包签名，秘密值留在用户手里。track_crosschain_swap—— 追踪两条链上的交易阶段：TON 侧是否已锁定、EVM 侧是否出现了对应锁定、秘密值是否已披露、结算是否完成。disclose_crosschain_secret—— 披露秘密值以完成结算，但必须先在链上确认就绪。这是一道防线，防止过早披露秘密值而失去对交易的控制。build_crosschain_refund—— 当交易卡住并触发超时后，构建从锁定合约中取回资金的退款交易。
一笔交易的完整生命周期
智能体从报价一路跑到结算或退款的流程如下：
get_crosschain_quote → 报价 TON → Base
build_crosschain_swap_tx → 未签名的 HTLC 锁定交易 + 秘密值
（用户用自己的钱包签名锁定交易）
track_crosschain_swap → 等待对手方就绪
disclose_crosschain_secret → 披露秘密值，进入结算
── 如果卡住 ──
build_crosschain_refund → 从锁定合约退款
注意：退款是设计的一部分，不是事后打的补丁。正是 build_crosschain_refund 让整套结构对自主智能体足够安全：即使中途出了问题，资金也不会被卡死——始终存在一条确定性的退回路径。这五个工具把“吓人的跨链桥”变成了一个可预测的、按部就班的流程。
TONNode 的护城河：非托管 + 跨链 + hosted
来跟官方包做一次坦诚的对比。TON Foundation 的 @ton/mcp 是一个托管型智能体钱包，采用 split-key 方案：operator 密钥在智能体手里，owner 密钥在用户手里，签名由智能体自己完成。它能做的很多——读链、发送 GRAM/jetton/NFT、通过 DEX 聚合器兑换、操作 NFT 和 DNS、创建和导入智能体钱包，而且它是官方出品。这些都是实打实的优势，没必要贬低。
但有两个限制很关键：
- 它是托管的——operator 密钥在智能体手里，也就是说智能体可以自主花钱。有些场景这很方便，另一些场景这是不可接受的风险。
- 它只支持 TON——没有跨链。
TONNode 在三个维度上不同：
官方 @ton/mcp |
TONNode | |
|---|---|---|
| 密钥模型 | 托管（split-key，自行签名） | 非托管（返回未签名的 TonConnect 消息） |
| 跨链 | 无，仅 TON | TON → 6 条 EVM 网络，原子化 HTLC |
| 部署方式 | 本地 / HTTP / serverless | 本地（npx）外加 hosted 端点 |
非托管不是一个待勾选的功能项，而是架构层面的护城河。服务器从不签名、从不保管资金和私钥。就连 generate_wallet（创建 v3r2 / v4 / v5r1 / highload_v3 版本的新 TON 钱包）也是把助记词和密钥交给用户——服务器不做任何保存。两种路线的详细对比见托管 vs 非托管 MCP。
一个小小的术语说明，免得混淆：GRAM 就是改名后的 Toncoin（改名发生在 2026 年 6 月），网络本身仍然叫 TON。
如何接入并搭建你自己的 DeFAI 智能体
上手可以完全免费、完全本地，不用绑卡也不用注册。@tonnode/mcp 包是开源的（MIT），走 TON 原生的 ADNL 协议，中间没有 HTTP 层。
本地与 hosted 配置
本地配置（公共节点集，完整读取能力）——直接加进你的 MCP 客户端配置即可：
{
"mcpServers": {
"ton": { "command": "npx", "args": ["-y", "@tonnode/mcp"] }
}
}
Hosted 端点（有保障的吞吐量，独立密钥）：
{
"mcpServers": {
"ton": {
"type": "http",
"url": "https://mcp.tonnode.io/mcp",
"headers": { "Authorization": "Bearer tn_live_…" }
}
}
}
这份配置适用于任何 MCP 客户端：Claude、Cursor、ChatGPT/Codex。
DeFAI 智能体骨架
基于 TONNode 工具的 DeFAI 智能体骨架——典型的“去另一条链建仓”流程：
先查用户手里有什么：
get_balance → GRAM 余额
get_jetton_info → jetton 的 decimals（USDT = 6，通常为 9）
get_jetton_balance → USDT/jetton 余额（钱包地址在链上推导）
如果用户想在 TON 链内兑换：
get_swap_quote → build_swap_tx → 在钱包中签名
如果用户想把价值转到 Base/Ethereum/…：
get_crosschain_quote
→ build_crosschain_swap_tx（签名，秘密值留在用户手里）
→ track_crosschain_swap（等待就绪）
→ disclose_crosschain_secret（结算）
→ build_crosschain_refund（如果卡住）
剩下的全靠系统提示词——客户端会自己路由工具调用：
你是 TON 上的 DeFAI 助手。规则：
1. 展示任何 jetton 金额之前，先调用 get_jetton_info（decimals）
和 get_jetton_balance。
2. 兑换：先 get_swap_quote，把汇率展示给用户，再 build_swap_tx。
永远不要索要私钥——交易由用户的钱包
通过 TonConnect 签名。
3. 跨链：get_crosschain_quote → build_crosschain_swap_tx →
track_crosschain_swap → disclose_crosschain_secret。
源链永远是 TON，目标链是 6 条 EVM 网络之一
（Ethereum、Arbitrum、Base、BNB Chain、Polygon、Avalanche）；
不支持 TRON。
4. 如果交易卡住——建议 build_crosschain_refund。
交易型智能体的逐步搭建我们单独写了一篇——如何在 TON 上构建交易智能体。
价格方案
所有方案都能用全部 16 个工具，你只为吞吐量付费：
- Hobby —— 永久免费，60 请求/分钟
- Pro —— $29/月，300 请求/分钟
- Scale —— $199/月，1200 请求/分钟
Hobby 的免费密钥登录后立即发放，无需绑卡。Pro/Scale 可以通过 TonConnect 用 TON 网络上的 GRAM 或 USDT 支付，也可以通过 Telegram 里的 xRocket 账单用 BTC/ETH/SOL 等支付；付款结算后密钥自动发放。
只读 MCP 让智能体成为观察者。非托管兑换和跨链让它成为执行者——而且不需要从用户手里拿走密钥。会读 TON 的工具很多；能把价值从 TON 转移到六条 EVM 网络、又不经手密钥的，目前只有 TONNode。这就是 TON 上的 DeFAI：智能体转移价值，控制权留在所有者手中。
现在就领取免费的 Hobby 密钥，接入你的第一个智能体 → tonnode.io/dashboard?plan=hobby
延伸阅读：完整工具列表见 tonnode.io/mcp，限额与价格见 tonnode.io/pricing。