izzzzzi/izTolkMcp

izzzzzi/izTolkMcp

от izzzzzi
MCP-сервер для компилятора Tolk — разрабатывай смарт-контракты TON прямо в AI-ассистенте. Компилируй код, проверяй синтаксис и генерируй ссылки для деплоя без выхода из чата. Полезен разработчикам TON, работающим с Tolk.

iz-tolk-mcp

MCP server for the Tolk smart contract compiler — compile, check, and deploy TON blockchain smart contracts from any AI assistant

CI npm version npm downloads License: MIT TypeScript Node.js

🇷🇺 Русский | 🇬🇧 English


MCP server that brings the Tolk smart contract compiler directly into AI assistants like Claude — write, compile, check, and deploy TON contracts without leaving the conversation.


📖 Overview

iz-tolk-mcp is a Model Context Protocol (MCP) server that integrates the Tolk smart contract compiler into AI assistants, enabling a seamless write-compile-deploy workflow for TON blockchain development.

  • Tolk is the next-generation smart contract language for the TON blockchain, designed as a modern successor to FunC with familiar syntax (C/TypeScript-like), type safety, and cleaner semantics.
  • MCP (Model Context Protocol) is an open standard that lets AI assistants use external tools, access data sources, and follow guided workflows — turning them into capable development environments.

✨ Features

Feature Description
🔨 4 MCP Tools compile_tolk, check_tolk_syntax, get_compiler_version, generate_deploy_link
📄 6 MCP Resources Language guide, stdlib reference, changelog, FunC migration guide, example contracts
💬 3 MCP Prompts Guided workflows for writing, reviewing, and debugging smart contracts
⚙️ Full Compiler Options Optimization levels (0-2), stack comments, path mappings, multi-file compilation
📦 Multi-file Support Compile projects with multiple .tolk source files, @stdlib/* and @fiftlib/* imports
🔗 Deployment Links Generate ton:// deeplinks and Tonkeeper URLs for wallet deployment
🚀 Zero Configuration Runs via npx with no external dependencies beyond Node.js
Инструменты были проиндексированы:
check_tolk_syntax

Проверяет исходный код Tolk на синтаксические и типовые ошибки без вывода полного результата компиляции. Ускоряет обратную связь для итеративной разработки. Поддерживает pathMappings для разрешения импорта через собственные @alias. При успехе возвращает OK + хэш кода, при ошибке — детали ошибки.

Параметры
  • entrypointFileNamestringобязательный

    Основной .tolk файл для проверки (например, "main.tolk")

  • pathMappingsobject

    Сопоставляет префиксы @alias с абсолютными путями к папкам для разрешения импорта. Пример: {"@mylib": "/path/to/mylib"}

  • sourcesobjectобязательный

    Объект, который сопоставляет имя файла с содержимым исходного кода. Обязательно должен включать файл точки входа. Пример: {"main.tolk": "fun main(): int { return 0; }"}

compile_tolk

Компилирует исходный код смарт-контрактов Tolk с помощью @ton/tolk-js. Передавайте исходные файлы в виде карты «имя файла -> содержимое». Файл точки входа должен быть включён. Импорты стандартной библиотеки (@stdlib/, @fiftlib/) разрешаются автоматически. Поддерживает pathMappings для разрешения пользовательских импортов через @alias. Возвращает скомпилированный код Fift, BoC (Bag of Cells) в base64, хеш кода и версию компилятора.

Параметры
  • entrypointFileNamestringобязательный

    Основной компилируемый файл .tolk (например, "main.tolk")

  • optimizationLevelinteger

    Уровень оптимизации 0-2 (по умолчанию: 2)

  • pathMappingsobject

    Сопоставляет префиксы @alias с абсолютными путями к папкам для разрешения импорта. Пример: {"@mylib": "/path/to/mylib"}

  • sourcesobjectобязательный

    Объект, который сопоставляет имя файла с содержимым исходного кода. Обязательно должен включать файл точки входа. Пример: {"main.tolk": "fun main(): int { return 0; }"}

  • withStackCommentsboolean

    Включать комментарии о расположении стека в вывод Fift

generate_deploy_link

Генерирует TON-диплинк для развертывания скомпилированного контракта на Tolk. Принимает скомпилированный код BoC (base64) и, опционально, начальные данные BoC. Вычисляет адрес контракта и возвращает ton://-диплинки для развертывания через кошелек.

Параметры
  • amountstring

    Сумма в nanoTON для отправки вместе с deploy-сообщением (по умолчанию: "50000000" = 0.05 TON)

  • codeBoc64stringобязательный

    Base64-кодированный BoC скомпилированного кода контракта (из вывода compile_tolk)

  • initialDataBoc64string

    BoC в кодировке Base64 для ячейки начальных данных контракта (по умолчанию: пустая ячейка)

  • workchainnumber

    Целевой workchain ID (по умолчанию: 0, basechain)

get_compiler_version

Возвращает версию компилятора Tolk (из @ton/tolk-js WASM). Используйте это, чтобы проверить, какая версия компилятора доступна.

Параметры

Без параметров.

1.3.1основная
1.3.0
1.2.1
1.2.0
1.1.1
1.1.0
1.0.0

Выберите клиент, чтобы установить izzzzzi/izTolkMcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "izzzzzi-iztolkmcp-kkztw4aivi": {
      "command": "npx",
      "args": [
        "-y",
        "iz-tolk-mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "izzzzzi-iztolkmcp-kkztw4aivi": {
      "command": "npx",
      "args": [
        "-y",
        "iz-tolk-mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "izzzzzi-iztolkmcp-kkztw4aivi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "iz-tolk-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"izzzzzi-iztolkmcp-kkztw4aivi\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"iz-tolk-mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "izzzzzi-iztolkmcp-kkztw4aivi": {
      "command": "npx",
      "args": [
        "-y",
        "iz-tolk-mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add izzzzzi-iztolkmcp-kkztw4aivi -- npx -y iz-tolk-mcp

Либо через JSON-конфиг:

claude mcp add-json izzzzzi-iztolkmcp-kkztw4aivi "{\"command\":\"npx\",\"args\":[\"-y\",\"iz-tolk-mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add izzzzzi-iztolkmcp-kkztw4aivi -- npx -y iz-tolk-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.izzzzzi-iztolkmcp-kkztw4aivi]
command = "npx"
args = ["-y", "iz-tolk-mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите izzzzzi/izTolkMcp, а в поле команды запуска — строку ниже:
npx -y iz-tolk-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "izzzzzi-iztolkmcp-kkztw4aivi": {
      "command": "npx",
      "args": [
        "-y",
        "iz-tolk-mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "izzzzzi-iztolkmcp-kkztw4aivi": {
      "command": "npx",
      "args": [
        "-y",
        "iz-tolk-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например izzzzzi-iztolkmcp-kkztw4aivi.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: izzzzzi-iztolkmcp-kkztw4aivi
    command: npx
    args:
      - "-y"
      - "iz-tolk-mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "izzzzzi-iztolkmcp-kkztw4aivi": {
      "command": "npx",
      "args": [
        "-y",
        "iz-tolk-mcp"
      ]
    }
  }
}

Похожие MCP-сервера

mcpdotdirect/starknet-mcp-server

mcpdotdirect/starknet-mcp-server

от mcpdotdirect

MCP-сервер для интеграции AI-агентов с блокчейном Starknet. Предоставляет инструменты для запросов данных сети, управления кошельками, работы со смарт-контрактами и StarknetID. Полезен разработчика...

TypeScript⭐ 7
nearai/near-mcp

nearai/near-mcp

от nearai

MCP сервер для блокчейна NEAR дает AI-агентам возможность управлять аккаунтами, подписывать транзакции и выполнять смарт-контракты. Полезен разработчикам, интегрирующим NEAR в AI-решения.

TypeScript⭐ 31
Quantum3-Labs/ARBuilder

Quantum3-Labs/ARBuilder

от quantum3-labs

MCP сервер для создания смарт-контрактов и dApps в экосистеме Arbitrum. ARBuilder по текстовому описанию генерирует Stylus контракты на Rust, настраивает кросс-чейн взаимодействие и помогает с развёртыванием Orbit chain. Полезен разработчикам, работающим с Arbitrum.

TypeScript⭐ 24
sei-protocol/sei-mcp-server

sei-protocol/sei-mcp-server

от sei-protocol

MCP сервер для Sei блокчейна, который даёт AI-агентам доступ к данным on-chain, смарт-контрактам и токенам. Включает балансы, транзакции, переводы ERC20 и NFT - всё через единый интерфейс.

TypeScript⭐ 13
Pentagonal-ai/pentagonal

Pentagonal-ai/pentagonal

от pentagonal-ai

MCP-сервер Pentagonal — AI-инструмент для аудита и генерации смарт-контрактов на Solidity и Rust. Восемь агентов проводят пентест с отчётом, детектируют honeypot и исправляют уязвимости. Поддержка 8 блокчейнов, самообучающиеся правила безопасности и бесплатные базовые функции.

TypeScript⭐ 1
kukapay/ethereum-validator-queue-mcp

kukapay/ethereum-validator-queue-mcp

от kukapay

MCP сервер для отслеживания очередей активации и выхода валидаторов Ethereum в реальном времени. Предоставляет статистику очередей, статус конкретного валидатора по публичному ключу и шаблон для анализа трендов стейкинга. Помогает разработчикам мониторить динамику сети и участие в стейкинге.

Python⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин