TON MCP: TONNode пен ресми @ton/mcp — адал салыстыру

@ton/mcp пен TONNode: адал салыстыру — және бірінші сұрақ: кілттерді кім ұстайды?

TON үшін жасалған екі MCP-дің бұл салыстыруы фичалар тізімінен емес, бір ғана қауіпсіздік сұрағынан басталады. Елестетіңіз: сіз Claude немесе Cursor-ға TON-ға қатынау мүмкіндігін бердіңіз. Агент балансты оқиды, свап жинайды, get-әдістерді шақырады. Бәрі жұмыс істейді — транзакцияға қол қою керек болатын сәтке дейін. Міне, түнгі 3-те агент қисық промпт бойынша (немесе вебтен таңылған нұсқаулық бойынша) «портфельді оңтайландыруды» ұйғарып, транзакцияға өзі қол қояды. Қаражат кетті. Сіз бұл туралы таңертең білесіз.

Бұл — қорқыту емес, бір архитектуралық таңдаудың тікелей салдары: агент өз кілтімен өзі қол қоя ма, әлде қолтаңба әрқашан пайдаланушының әмиянында қала ма? TON үшін жасалған екі жетілген MCP — TON Foundation-ның ресми @ton/mcp пакеті мен TONNode — дәл осы нүктеде жолдары айырылады. Екеуі де агентке блокчейнде әрекет етуге мүмкіндік береді. Ешқайсысын кемсітпей, адал талдап көрейік — әртүрлі міндеттер үшін екі тәсілдің де өмір сүруге құқығы бар.

Не үшін салыстырамыз: TON-ға арналған MCP-дің екі түрлі тәсілі

MCP (Model Context Protocol) — ЖИ-агенттер (Claude, Cursor, ChatGPT/Codex және кез келген MCP-клиент) құралдарды шақыратын стандарт. TON үшін бұл былай көрінеді: агент get_balance немесе build_swap_tx тәрізді функциялар жиынтығын алады да, диалог барысында қажет деп тапқанда оларды өзі шақырады.

@ton/mcp пен TONNode арасындағы айырмашылық — командалар тізімінде емес, философияда. Аналогия: @ton/mcp — көмекшіңізге лимиті бар корпоративтік карта беру сияқты: ол өзі, жылдам әрі автономды түрде төлейді, бірақ карта оның қолында. TONNode — төлем тапсырмасын дайындап, қол қоюға сізге әкелетін көмекші: сіздің әмияныңызсыз ештеңе кетпейді. Екі модель де жұмысқа жарайды. Мәселе — қай міндетке қайсысы керек екенінде.

Мәселенің теориялық жағы қызық болса — кастодиалды және кастодиалды емес MCP туралы бөлек талдау бар. Мұнда нақтылықты салыстырамыз.

Ресми @ton/mcp: NFT мен DNS-і бар кастодиалды агент-әмиян

@ton/mcp — TON Foundation-ның ресми пакеті, әрі бұл — оның күшті жағы: желі командасының қолдауы, болжамды даму, эталон мәртебесі.

Архитектурасы бойынша бұл — split-key моделімен жұмыс істейтін кастодиалды агент-әмиян:

• operator-кілт — агентте. Онымен агент транзакцияларға өзі қол қояды, сіздің қатысуыңызсыз.
• owner-кілт — пайдаланушыда, әмиянды бақылаудың екінші контуры ретінде.

Қорабынан шыға сала не істей алады:

• желінің, аккаунттардың, баланстардың күйін оқу;
• GRAM, жетон және NFT жіберу (агент өзі қол қояды);
• DEX-агрегатор арқылы свап;
• агент-әмияндарды құру және импорттау;
• NFT мен DNS-ті оқу — TONNode-та әзірге жоқ нәрсе, әрі бұл ресми пакеттің адал артықшылығы.

Жергілікті, HTTP арқылы немесе serverless режимінде іске қосылады. Дизайны бойынша шектеу: тек TON, кроссчейн жоқ.

Мұндағы басты нәрсе — автономия. Агент қол қою циклінде адам болмай-ақ, қаражатты өзі жұмсайды. «Жазылым/газ/микротапсырмалар үшін агент өзі төлей берсін» деген сценарийлер үшін керегі дәл осы. Бірақ дәл сол автономия мынаны білдіреді: қаражатты билейтін жұмыс кілті агент жағында тұр — демек, промпт-инъекция немесе модельдің галлюцинациясы нақты шығынға апара алады.

TONNode: кастодиалды емес MCP, кроссчейн және hosted-опция

TONNode — TON үшін дәл 16 құралы бар hosted MCP-сервер (сайты tonnode.io). Түйінді инвариант бір сөйлеммен:

Сервер ешқашан қол қоймайды әрі қаражат пен жеке кілттерді сақтамайды. Свап, кроссчейн және әмиян құралдары қол қойылмаған TonConnect-хабарламаларын қайтарады. Оларға пайдаланушының әмияны қол қояды.

Сервер қаражатты алып кете алатын сәт мүлдем жоқ, өйткені онда кілт физикалық тұрғыда жоқ. Топтарға бөліп талдайық.

Оқу (7+1)

Күнделікті қажеттіліктің бәрін жабады:

get_masterchain_info — мастерчейннің басы
get_balance          — GRAM балансы
get_account_state    — статус, жалаушалар, соңғы транзакция
get_transactions     — транзакциялар тарихы
run_get_method       — контракттың кез келген read-only get-әдісі
get_jetton_balance   — жетон/USDT балансы (жетон әмияны он-чейн есептеледі)
get_jetton_info      — жетонның метадеректері: аты, символы, decimals, эмиссиясы
parse_address        — EQ/UQ/raw конверттеу, офлайн

get_jetton_info decimals мәнін береді — ол raw-бірліктерді қайта санау үшін керек: USDT-де ол 6, жетондардың көпшілігінде 9.

Свап (2)

Omniston протоколы арқылы жүреді — STON.fi мен DeDust-тың біріктірілген өтімділігі:

• get_swap_quote — GRAM⇄жетон бойынша нақты котировка;
• build_swap_tx — TonConnect үшін дайын, қол қойылмаған транзакция.

Кроссчейн (5)

Ресми пакетте мүлдем жоқ нәрсе. Атомарлық HTLC-эскроу, мұнда TON әрқашан бастау көзі:

• get_crosschain_quote — котировка;
• build_crosschain_swap_tx — қол қойылмаған HTLC-эскроу транзакциясы + құпия;
• track_crosschain_swap — екі желідегі мәміле фазалары;
• disclose_crosschain_secret — он-чейн дайындықты тексергеннен кейін есеп айырысу үшін құпияны ашу;
• build_crosschain_refund — мәміле кідіріп қалса, эскроудан қаражатты қайтару.

Қолдау көрсетілетін желілер: Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche. TRON-ға әзірге қолдау көрсетілмейді. Мұндай мәміленің қалай құрылғаны TON-дағы агент үшін алғашқы кроссчейн туралы материалда көрсетілген.

Әмиян (1): generate_wallet v3r2/v4/v5r1/highload_v3 нұсқаларындағы әмиянды жасайды әрі мнемониканы, кілттерді және мекенжайды пайдаланушыға береді — сервер оларды сақтамайды.

TONNode-та әзірге жоқ нәрсе: NFT мен DNS құралдары — олар роадмапта. Егер міндет дәл бүгін NFT-коллекцияларды оқу немесе .ton-домендерді резолвтеу болса, бұл — ресми пакеттің аймағы. Назар аударыңыз: GRAM немесе жетонды «жіберу/аудару» деген тікелей құрал да TONNode-та жоқ. Қол қойылмаған транзакцияны құратын құралдардың бәрі — build_swap_tx, build_crosschain_swap_tx және build_crosschain_refund, яғни қаражат аудару тек свап, кроссчейн немесе эскроудан қайтару шеңберінде ғана мүмкін. Еркін «send» мұнда дизайны бойынша жоқ.

Салыстыру кестесі: @ton/mcp пен TONNode

Критерий	Ресми @ton/mcp	TONNode
Кім қол қояды	Агенттің өзі (operator-кілт, split-key)	Пайдаланушының әмияны (сервер қол қоймайды)
Модель	Кастодиалды	Қатаң түрде кастодиалды емес
Автономды жұмсау	Иә	Жоқ (дизайны бойынша)
GRAM/жетондарды тікелей жіберу	Иә, автономды	Бөлек құрал жоқ; аудару — тек свап/кроссчейн ішінде, қол қойылмаған tx түрінде
Свап	DEX-агрегатор	Omniston (STON.fi + DeDust)
Кроссчейн	Жоқ (тек TON)	Иә, 6 желіге HTLC-эскроу
NFT / DNS	Бар (оқу)	Роадмапта
Әмиян генерациялау	Агент-әмияндарды құру/импорттау	v3r2/v4/v5r1/highload_v3, кілттер пайдаланушыда
Іске қосу	Жергілікті / HTTP / serverless	Жергілікті (npx) + hosted-эндпоинт
Мәртебесі	Ресми, TON Foundation	Тәуелсіз, open source (MIT)

Түйінді жол айрығы: агенттің кілттерін кім ұстайды

Қалғанының бәрі — ұсақ-түйек. Нағыз таңдау бір сұрақта: транзакцияларға агенттің өзі қол қоюына дайынсыз ба?

@ton/mcp-те operator-кілт агентте — демек агент промпт бойынша, адам қолтаңбасы түріндегі екінші факторсыз-ақ қаражат жұмсай алады. Бұл автономия үшін қуатты, ал промпт-инъекция немесе галлюцинация кезінде қауіпті: компрометацияға ұшыраған контекст = ықтимал жұмсалған қаражат.

TONNode-та қолтаңба серверде физикалық тұрғыда орындала алмайды. Тіпті агент «ақылынан адасып», build_swap_tx-ті мағынасыз параметрлермен шақырса да, ең көп дегенде алатыны — қол қойылмаған транзакция нысаны. Пайдаланушының әмияны оны растамайынша, ештеңе қозғалмайды. Бұл — саясат емес, архитектуралық кепілдік.

Ешбір тәсіл жалпы алғанда «жақсырақ» емес — олар агенттің автономиясына деген сенімнің әртүрлі деңгейі туралы.

Ресми @ton/mcp-ті қашан, ал TONNode-ты қашан таңдау керек

@ton/mcp-ті алыңыз, егер:

• автономды жұмсау керек болса — агент циклде адам болмай-ақ өзі төлеп, өзі қол қояды;
• қатаң түрде TON ішінде жұмыс істесеңіз, кроссчейн керек болмаса;
• NFT мен DNS дәл бүгін керек болса;
• Foundation пакетінің ресми мәртебесі маңызды болса.

TONNode-ты алыңыз, егер:

• ақшаны тек пайдаланушының әмияны билеуі керек болса, агент емес — бұл паттерн TON-дағы агенттерге арналған кастодиалды емес свап туралы материалда талданған;
• TON⇄EVM кроссчейні керек болса (Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche);
• Omniston-ның біріктірілген өтімділігі арқылы свап керек болса;
• тек жергілікті іске қосу емес, кепілдендірілген өткізу қабілеті бар hosted-эндпоинт керек болса.

Бұл «жақсырақ/нашарырақ» емес, әртүрлі құралдар. Тәсілдер бірін-бірі жоққа шығармайды: көптеген команда конфигте екі серверді де ұстайды — NFT/DNS пен автономды міндеттерге ресмиін, кастодиалды емес свап пен кроссчейнге TONNode-ты.

Әрқайсысын қалай қосуға болады

Мұнда алғаш келсеңіз, TON үшін MCP-ге жалпы кіріспені TON-ға арналған MCP гайдынан табасыз.

TONNode жергілікті — тегін, оқудың толық жиынтығы

@tonnode/mcp пакеті — open source (MIT, npm-де және GitHub-та tonnode/mcp), TON-ның нативті ADNL-протоколы бойынша, HTTP-қабаттарсыз жұмыс істейді:

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

TONNode hosted — өз кілтіңіз, кепілдендірілген өткізу қабілеті

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": { "Authorization": "Bearer tn_live_…" }
    }
  }
}

Қосылғаннан кейін агентке кәдімгі мәтіндік тапсырмалар беруге болады — құралды ол өзі таңдайды:

EQ… әмиянындағы USDT балансымды get_jetton_balance арқылы тексер.
Содан кейін 50 USDT-ны GRAM-ға айырбастауға get_swap_quote ал
және build_swap_tx арқылы транзакция жина.
Транзакцияны жіберме — әмиянда қол қою үшін маған қайтар.

Агент get_jetton_balance → get_swap_quote → build_swap_tx шақырады да, қол қойылмаған TonConnect-хабарламасын береді. Ақша тек әмиянда растағаннан кейін ғана қозғалады.

Кроссчейн тапсырмасы да дәл солай табиғи көрінеді:

TON-дағы 100 GRAM-ды Base желісіндегі USDC-ға айырбастауды жина.
get_crosschain_quote бер, содан кейін build_crosschain_swap_tx.
Құпияны сақтап қой, статусты track_crosschain_swap арқылы қадағала.

Барлық тарифте 16 құралдың бәрі қолжетімді — сіз тек өткізу қабілеті үшін төлейсіз: Hobby — мәңгілікке тегін, 60 сұрау/мин; Pro — $29/ай, 300 сұрау/мин; Scale — $199/ай, 1200 сұрау/мин. Hobby кілті кірген бойда, картасыз беріледі.

Ресми @ton/mcp

@ton/mcp TON Foundation нұсқаулығы бойынша орнатылады әрі жергілікті, HTTP арқылы немесе serverless режимінде іске қосылады. Алғашқы баптау кезінде агент үшін operator-кілті бар агент-әмиян құрылады немесе импортталады. Кастодиалды модельді ескеріңіз: лимиттерді және агент қандай қаражатқа қатынау алатынын алдын ала ойластырыңыз.

Қорытынды

@ton/mcp — ресми кастодиалды агент-әмиян: split-key, автономды жұмсау, NFT және DNS, тек TON. TONNode — 16 құралдан тұратын кастодиалды емес сервер: сервер ешқашан қол қоймайды, 6 желіге кроссчейн мен hosted-опция қосады. Айырмашылық адал әрі архитектуралық — қол қою құқығын кімге сенетініңіз туралы. Кім қол қойса, тәуекел профилін де сол шешеді.

Әр құрал бойынша егжей-тегжейлі салыстыру — TONNode ресми MCP-ге қарсы бетінде. Кастодиалды емес тәсілді дәл қазір, картасыз тегін Hobby кілтімен байқап көруге болады: tonnode.io/dashboard?plan=hobby.