tonnode/mcp

开发工具官方

本页由 AI 翻译，技术细节请以原文为准。查看原文

27 stars 0 forks 质量 83 趋势 25MIT

Repository Install

tonnode/mcp 是从 https://github.com/tonnode/mcp. 导入的 MCP 服务器候选

概览

tonnode/mcp 是从 https://github.com/tonnode/mcp. 导入的 MCP 服务器候选

概述（AI 翻译）

Русская версия

MCP服务器为AI代理提供直接liteserver访问开放网络（TON）的权限——中间没有HTTP网关。通过TON原生ADNL协议提供余额、账户状态、交易历史和合约获取方法。

由TONNode构建——私有TONliteserver、归档节点、mempool流和REST API（抢先体验，应请求）。

快速开始

添加到Claude Desktop、Claude Code、ChatGPT、Cursor、Codex或任何MCP客户端：

这就是整个集成过程。服务器默认通过公开的全局配置连接到TON主网。每个客户端的现成配置——加上程序化Node.js使用——都存在示例中。

工具

命名说明： 本地硬币于2026年6月由Toncoin更名为GRAM;网络本身仍称为TON。工具输出使用*_gram字段。

工具	它的作用	典型问题
`get_balance`	地址的GRAM余额	“EQ…保持多少GRAM？”
`get_jetton_balance`	Jetton/代币余额（USDT及任何TEP-74代币）	“该钱包中有多少USDT？”
`get_jetton_info`	令牌元数据：名称、符号、小数点、供应	“这个jetton的小数是多少？”

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

@tonnode/mcp

Русская версия

MCP server that gives AI agents direct liteserver access to The Open Network (TON) — no HTTP gateways in the middle. Balances, account state, transaction history and contract get-methods over TON’s native ADNL protocol.

Built by TONNode — private TON liteservers, archive nodes, a mempool stream and a REST API (early access, on request).

Quick start

Add to Claude Desktop, Claude Code, ChatGPT, Cursor, Codex or any MCP client:

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"]
    }
  }
}

That’s the whole integration. The server connects to TON mainnet via the public global config by default. Ready-made configs for every client — plus programmatic Node.js usage — live in examples/.

Tools

Naming note: the native coin was renamed from Toncoin to GRAM in June 2026; the network itself is still called TON. Tool outputs use *_gram fields.

Tool	What it does	Typical question
`get_balance`	GRAM balance of an address	“How much GRAM does EQ… hold?”
`get_jetton_balance`	Jetton/token balance (USDT and any TEP-74 token)	“How much USDT is on this wallet?”
`get_jetton_info`	Token metadata: name, symbol, decimals, supply	“What are this jetton’s decimals?”
`get_transactions`	Recent transactions: values, senders, fees	“Did my payment arrive?”
`get_account_state`	Status, deployment flags, last-tx pointer	“Is this contract deployed?”
`run_get_method`	Read-only get-methods on contracts	“Call `get_jetton_data` on this master”
`parse_address`	Convert/validate EQ…/UQ…/raw forms, offline	“Are these two addresses the same?”
`get_masterchain_info`	Masterchain head: seqno, shard, hashes	“Is the network (or my endpoint) alive?”
`get_swap_quote`	Firm DEX swap quote (GRAM ⇄ any jetton) via Omniston	“How much USDT for 100 GRAM right now?”
`build_swap_tx`	Unsigned, TonConnect-ready swap transaction	“Prepare that swap for my wallet to sign”
`get_crosschain_quote`	Quote TON → Ethereum/Arbitrum/Base/BNB/Polygon/Avalanche	“How much USDT on Ethereum for my TON USDT?”
`build_crosschain_swap_tx`	Unsigned HTLC escrow transaction + its secret	“Start that cross-chain swap”
`track_crosschain_swap`	Live phases of a cross-chain trade on both chains	“Did the resolver lock my USDT on Ethereum?”
`disclose_crosschain_secret`	Reveal the secret — atomically settles both sides	“Complete the swap”
`build_crosschain_refund`	Unsigned cancellation that reclaims escrowed funds	“The trade stalled — get my money back”

在 GitHub 查看完整 README

安装

npx -y @tonnode/mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"]
    }
  }
}