iz-tolk-mcp 1.0.0

package/README.md

@@ -0,0 +1,322 @@
+[English](README.md) | [Русский](README.ru.md)
+
+# iz-tolk-mcp
+
+MCP server for the Tolk smart contract compiler — compile, check, and deploy TON blockchain smart contracts from any MCP-compatible AI assistant.
+
+## Overview
+
+**iz-tolk-mcp** is a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that brings the [Tolk](https://docs.ton.org/v3/documentation/smart-contracts/tolk/overview) smart contract compiler directly into AI assistants like Claude, 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.
+
+With this server, an AI assistant can write Tolk code, compile it, check for errors, read language documentation, and generate wallet-ready deployment links — all without leaving the conversation.
+
+## Features
+
+- **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, multi-file compilation
+- **Multi-file support** — compile projects with multiple `.tolk` source files and `@stdlib/*` imports
+- **Compiler changelog** — built-in version history from v0.6 to latest
+- **Deployment links** — generate `ton://` deeplinks and Tonkeeper URLs for wallet deployment
+- **Zero configuration** — runs via `npx` with no external dependencies beyond Node.js
+
+## Quick Start
+
+```bash
+npx iz-tolk-mcp
+```
+
+The server communicates over stdio and is designed to be launched by an MCP client.
+
+## Installation
+
+### Option A: npx (no install needed)
+
+MCP clients launch the server automatically — just add it to your configuration (see below).
+
+### Option B: Global install
+
+```bash
+npm install -g iz-tolk-mcp
+```
+
+### Option C: Clone and build
+
+```bash
+git clone https://github.com/izzzzzi/izTolkMcp.git
+cd iz-tolk-mcp
+npm install
+npm run build
+```
+
+> **Requirement:** Node.js >= 18
+
+## Configuration for MCP Clients
+
+### Claude Desktop
+
+File: `claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "npx",
+      "args": ["-y", "iz-tolk-mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+File: `.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "npx",
+      "args": ["-y", "iz-tolk-mcp"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+File: `~/.windsurf/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "npx",
+      "args": ["-y", "iz-tolk-mcp"]
+    }
+  }
+}
+```
+
+### Local build (any client)
+
+If you cloned and built the project locally:
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "node",
+      "args": ["/absolute/path/to/iz-tolk-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## Tools Reference
+
+### `get_compiler_version`
+
+Returns the version of the Tolk compiler bundled in `@ton/tolk-js` (WASM).
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| *(none)* | — | — | No parameters |
+
+---
+
+### `compile_tolk`
+
+Compiles Tolk smart contract source code. Returns Fift output, BoC (Bag of Cells) in base64, and the code hash.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `entrypointFileName` | `string` | Yes | The main `.tolk` file to compile (e.g., `"main.tolk"`) |
+| `sources` | `object` | Yes | Map of `filename -> source code`. Must include the entrypoint file. |
+| `optimizationLevel` | `number` | No | Optimization level 0-2 (default: 2) |
+| `withStackComments` | `boolean` | No | Include stack layout comments in Fift output |
+
+---
+
+### `check_tolk_syntax`
+
+Checks Tolk source code for syntax and type errors without returning full compilation output. Faster feedback loop for iterative development.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `entrypointFileName` | `string` | Yes | The main `.tolk` file to check |
+| `sources` | `object` | Yes | Map of `filename -> source code` |
+
+---
+
+### `generate_deploy_link`
+
+Generates TON deployment deeplinks for a compiled contract. Computes the deterministic contract address and returns `ton://` and Tonkeeper links ready for wallet deployment.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `codeBoc64` | `string` | Yes | Base64-encoded BoC of compiled contract code (from `compile_tolk`) |
+| `initialDataBoc64` | `string` | No | Base64-encoded BoC for initial data cell (default: empty cell) |
+| `workchain` | `number` | No | Target workchain ID (default: 0) |
+| `amount` | `string` | No | Deploy amount in nanoTON (default: `"50000000"` = 0.05 TON) |
+
+## Resources Reference
+
+| Resource | URI | Description |
+|----------|-----|-------------|
+| `language-guide` | `tolk://docs/language-guide` | Complete Tolk language syntax reference |
+| `stdlib-reference` | `tolk://docs/stdlib-reference` | Standard library modules and functions reference |
+| `changelog` | `tolk://docs/changelog` | Tolk compiler version history from v0.6 to latest |
+| `tolk-vs-func` | `tolk://docs/tolk-vs-func` | FunC to Tolk migration guide — key differences and comparison |
+| `example-counter` | `tolk://examples/counter` | Simple counter smart contract example in Tolk |
+| `example-jetton` | `tolk://examples/jetton` | Jetton (fungible token) minter contract example in Tolk |
+
+## Prompts Reference
+
+### `write_smart_contract`
+
+Guided workflow for writing a new Tolk smart contract on TON. Injects the language reference and a relevant example contract into the conversation context.
+
+| Argument | Type | Required | Description |
+|----------|------|----------|-------------|
+| `description` | `string` | Yes | Description of what the smart contract should do |
+| `contractType` | `"counter" \| "jetton" \| "nft" \| "wallet" \| "custom"` | No | Type of contract to create (default: `"custom"`) |
+
+### `review_smart_contract`
+
+Security-focused review of a Tolk smart contract. Checks for access control, message handling, integer overflow, gas management, storage integrity, and TON-specific vulnerabilities.
+
+| Argument | Type | Required | Description |
+|----------|------|----------|-------------|
+| `code` | `string` | Yes | The Tolk smart contract source code to review |
+
+### `debug_compilation_error`
+
+Diagnose and fix a Tolk compilation error. Analyzes the error against the language reference and provides corrected code.
+
+| Argument | Type | Required | Description |
+|----------|------|----------|-------------|
+| `errorMessage` | `string` | Yes | The compilation error message from the Tolk compiler |
+| `code` | `string` | Yes | The Tolk source code that failed to compile |
+
+## Usage Examples
+
+Once configured, you can interact with the Tolk MCP server through natural language in your AI assistant:
+
+**Compile a contract:**
+
+> "Compile this Tolk smart contract:"
+> ```tolk
+> import "@stdlib/tvm-dicts";
+>
+> fun onInternalMessage(myBalance: int, msgValue: int, msgFull: cell, msgBody: slice) {
+>     // handle messages
+> }
+> ```
+
+The assistant will call `compile_tolk` and return the compiled BoC, code hash, and Fift output.
+
+**Check syntax during development:**
+
+> "Check if this Tolk code has any errors — I just want a quick syntax check, not the full compilation output."
+
+The assistant will use `check_tolk_syntax` for faster feedback without returning Fift/BoC.
+
+**Write a new contract from scratch:**
+
+> "Write a simple counter contract for TON that stores a number and lets anyone increment it. Include a getter to read the current value."
+
+The assistant will use the `write_smart_contract` prompt, which injects the Tolk language guide and a relevant example, then iteratively compiles until the contract is error-free.
+
+**Review an existing contract:**
+
+> "Review this contract for security issues" *(paste code)*
+
+The assistant will use `review_smart_contract` to perform a structured security audit covering access control, gas management, and TON-specific attack vectors.
+
+**Debug a compilation error:**
+
+> "I'm getting this error when compiling: `unexpected token 'fun'` — here's my code:" *(paste code)*
+
+The assistant will use `debug_compilation_error` to diagnose the issue against the language reference and provide a fix.
+
+**Generate a deploy link:**
+
+> "Generate a deployment link for the contract we just compiled."
+
+The assistant will take the BoC from the previous compilation and call `generate_deploy_link` to produce a `ton://` deeplink you can open in Tonkeeper or any TON wallet.
+
+## Development
+
+```bash
+git clone https://github.com/izzzzzi/izTolkMcp.git
+cd iz-tolk-mcp
+npm install          # Install dependencies
+npm run build        # Compile TypeScript + copy content files
+npm run dev          # Run with tsx (hot reload for development)
+npm test             # Run test suite (vitest)
+```
+
+## Code Quality
+
+Pre-commit hooks enforce code quality automatically:
+
+- **Biome** — fast linter and formatter for TypeScript
+- **Husky** — Git hooks manager
+- **lint-staged** — runs checks only on staged files
+
+```bash
+npm run lint          # Check for lint errors
+npm run lint:fix      # Fix lint errors automatically
+npm run format        # Format code with Biome
+```
+
+Pre-commit hook runs `biome check --write` and `biome format --write` on all staged `.ts` files.
+
+## CI/CD
+
+This project uses automated CI/CD:
+
+- **GitHub Actions** — build, test, and lint on every push and PR
+- **Semantic Release** — automated versioning based on [Conventional Commits](https://www.conventionalcommits.org/):
+  - `feat:` — minor version bump (1.x.0)
+  - `fix:` — patch version bump (1.0.x)
+  - `feat!:` or `BREAKING CHANGE:` — major version bump (x.0.0)
+  - `chore:`, `docs:`, `refactor:` — no release
+- **Dependabot** — automated weekly dependency updates
+
+Releases are published to npm automatically when changes are pushed to `main`.
+
+## Architecture
+
+The server is organized into focused modules:
+
+```
+src/
+  index.ts        — Server initialization and stdio transport
+  tools.ts        — 4 MCP tools (compile, check, version, deploy)
+  resources.ts    — 6 MCP resources (docs, examples)
+  prompts.ts      — 3 MCP prompts (write, review, debug)
+  content/        — Bundled documentation and example contracts
+    language-guide.md
+    stdlib-reference.md
+    changelog.md
+    tolk-vs-func.md
+    example-counter.tolk
+    example-jetton.tolk
+```
+
+Key dependencies:
+
+- `@modelcontextprotocol/sdk` — MCP server framework
+- `@ton/tolk-js` — Tolk compiler (WASM, runs locally)
+- `@ton/core` — TON primitives for address computation and cell serialization
+- `zod` — Schema validation for tool parameters
+
+## License
+
+MIT

package/README.ru.md

@@ -0,0 +1,322 @@
+[English](README.md) | [Русский](README.ru.md)
+
+# iz-tolk-mcp
+
+MCP-сервер для компилятора смарт-контрактов Tolk — компиляция, проверка и деплой смарт-контрактов блокчейна TON из любого AI-ассистента с поддержкой MCP.
+
+## Обзор
+
+**iz-tolk-mcp** — это сервер [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), который интегрирует компилятор смарт-контрактов [Tolk](https://docs.ton.org/v3/documentation/smart-contracts/tolk/overview) непосредственно в AI-ассистенты, такие как Claude, обеспечивая бесшовный рабочий процесс «написание — компиляция — деплой» для разработки на блокчейне TON.
+
+- **Tolk** — это язык смарт-контрактов нового поколения для блокчейна TON, созданный как современный преемник FunC с привычным синтаксисом (в стиле C/TypeScript), типобезопасностью и более чистой семантикой.
+- **MCP** (Model Context Protocol) — это открытый стандарт, позволяющий AI-ассистентам использовать внешние инструменты, получать доступ к источникам данных и следовать управляемым рабочим процессам, превращая их в полноценные среды разработки.
+
+С помощью этого сервера AI-ассистент может писать код на Tolk, компилировать его, проверять на ошибки, читать документацию языка и генерировать ссылки для деплоя через кошелёк — и всё это не выходя из диалога.
+
+## Возможности
+
+- **4 MCP-инструмента** — `compile_tolk`, `check_tolk_syntax`, `get_compiler_version`, `generate_deploy_link`
+- **6 MCP-ресурсов** — руководство по языку, справочник стандартной библиотеки, журнал изменений, руководство по миграции с FunC, примеры контрактов
+- **3 MCP-промпта** — управляемые рабочие процессы для написания, ревью и отладки смарт-контрактов
+- **Полный набор опций компилятора** — уровни оптимизации (0-2), комментарии стека, многофайловая компиляция
+- **Многофайловая поддержка** — компиляция проектов с несколькими файлами `.tolk` и импортами `@stdlib/*`
+- **Журнал изменений компилятора** — встроенная история версий от v0.6 до последней
+- **Ссылки для деплоя** — генерация deeplink-ов `ton://` и URL-ов Tonkeeper для деплоя через кошелёк
+- **Без настройки** — запускается через `npx` без внешних зависимостей, кроме Node.js
+
+## Быстрый старт
+
+```bash
+npx iz-tolk-mcp
+```
+
+Сервер взаимодействует через stdio и предназначен для запуска MCP-клиентом.
+
+## Установка
+
+### Вариант A: npx (установка не требуется)
+
+MCP-клиенты запускают сервер автоматически — просто добавьте его в конфигурацию (см. ниже).
+
+### Вариант B: Глобальная установка
+
+```bash
+npm install -g iz-tolk-mcp
+```
+
+### Вариант C: Клонирование и сборка
+
+```bash
+git clone https://github.com/izzzzzi/izTolkMcp.git
+cd iz-tolk-mcp
+npm install
+npm run build
+```
+
+> **Требование:** Node.js >= 18
+
+## Настройка MCP-клиентов
+
+### Claude Desktop
+
+Файл: `claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "npx",
+      "args": ["-y", "iz-tolk-mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Файл: `.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "npx",
+      "args": ["-y", "iz-tolk-mcp"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Файл: `~/.windsurf/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "npx",
+      "args": ["-y", "iz-tolk-mcp"]
+    }
+  }
+}
+```
+
+### Локальная сборка (любой клиент)
+
+Если вы клонировали и собрали проект локально:
+
+```json
+{
+  "mcpServers": {
+    "tolk": {
+      "command": "node",
+      "args": ["/absolute/path/to/iz-tolk-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## Справочник инструментов
+
+### `get_compiler_version`
+
+Возвращает версию компилятора Tolk, входящего в состав `@ton/tolk-js` (WASM).
+
+| Параметр | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| *(нет)* | — | — | Без параметров |
+
+---
+
+### `compile_tolk`
+
+Компилирует исходный код смарт-контракта на Tolk. Возвращает Fift-вывод, BoC (Bag of Cells) в base64 и хеш кода.
+
+| Параметр | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| `entrypointFileName` | `string` | Да | Главный файл `.tolk` для компиляции (например, `"main.tolk"`) |
+| `sources` | `object` | Да | Словарь `имя файла -> исходный код`. Должен включать файл точки входа. |
+| `optimizationLevel` | `number` | Нет | Уровень оптимизации 0-2 (по умолчанию: 2) |
+| `withStackComments` | `boolean` | Нет | Включить комментарии расположения стека в Fift-вывод |
+
+---
+
+### `check_tolk_syntax`
+
+Проверяет исходный код на Tolk на синтаксические и типовые ошибки без возврата полного результата компиляции. Более быстрая обратная связь для итеративной разработки.
+
+| Параметр | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| `entrypointFileName` | `string` | Да | Главный файл `.tolk` для проверки |
+| `sources` | `object` | Да | Словарь `имя файла -> исходный код` |
+
+---
+
+### `generate_deploy_link`
+
+Генерирует deeplink-и для деплоя скомпилированного контракта в сети TON. Вычисляет детерминированный адрес контракта и возвращает ссылки `ton://` и Tonkeeper, готовые для деплоя через кошелёк.
+
+| Параметр | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| `codeBoc64` | `string` | Да | BoC скомпилированного кода контракта в base64 (из `compile_tolk`) |
+| `initialDataBoc64` | `string` | Нет | BoC начальной ячейки данных в base64 (по умолчанию: пустая ячейка) |
+| `workchain` | `number` | Нет | ID целевого воркчейна (по умолчанию: 0) |
+| `amount` | `string` | Нет | Сумма деплоя в наноTON (по умолчанию: `"50000000"` = 0.05 TON) |
+
+## Справочник ресурсов
+
+| Ресурс | URI | Описание |
+|--------|-----|----------|
+| `language-guide` | `tolk://docs/language-guide` | Полный справочник синтаксиса языка Tolk |
+| `stdlib-reference` | `tolk://docs/stdlib-reference` | Справочник модулей и функций стандартной библиотеки |
+| `changelog` | `tolk://docs/changelog` | История версий компилятора Tolk от v0.6 до последней |
+| `tolk-vs-func` | `tolk://docs/tolk-vs-func` | Руководство по миграции с FunC на Tolk — ключевые отличия и сравнение |
+| `example-counter` | `tolk://examples/counter` | Пример простого смарт-контракта счётчика на Tolk |
+| `example-jetton` | `tolk://examples/jetton` | Пример контракта минтера Jetton (взаимозаменяемый токен) на Tolk |
+
+## Справочник промптов
+
+### `write_smart_contract`
+
+Управляемый рабочий процесс для написания нового смарт-контракта на Tolk для TON. Внедряет справочник языка и релевантный пример контракта в контекст диалога.
+
+| Аргумент | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| `description` | `string` | Да | Описание того, что должен делать смарт-контракт |
+| `contractType` | `"counter" \| "jetton" \| "nft" \| "wallet" \| "custom"` | Нет | Тип создаваемого контракта (по умолчанию: `"custom"`) |
+
+### `review_smart_contract`
+
+Ревью смарт-контракта на Tolk с фокусом на безопасность. Проверяет контроль доступа, обработку сообщений, целочисленное переполнение, управление газом, целостность хранилища и уязвимости, специфичные для TON.
+
+| Аргумент | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| `code` | `string` | Да | Исходный код смарт-контракта на Tolk для ревью |
+
+### `debug_compilation_error`
+
+Диагностика и исправление ошибки компиляции Tolk. Анализирует ошибку на основе справочника языка и предоставляет исправленный код.
+
+| Аргумент | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| `errorMessage` | `string` | Да | Сообщение об ошибке компиляции от компилятора Tolk |
+| `code` | `string` | Да | Исходный код на Tolk, который не удалось скомпилировать |
+
+## Примеры использования
+
+После настройки вы можете взаимодействовать с MCP-сервером Tolk через естественный язык в вашем AI-ассистенте:
+
+**Компиляция контракта:**
+
+> «Скомпилируй этот смарт-контракт на Tolk:»
+> ```tolk
+> import "@stdlib/tvm-dicts";
+>
+> fun onInternalMessage(myBalance: int, msgValue: int, msgFull: cell, msgBody: slice) {
+>     // handle messages
+> }
+> ```
+
+Ассистент вызовет `compile_tolk` и вернёт скомпилированный BoC, хеш кода и Fift-вывод.
+
+**Проверка синтаксиса во время разработки:**
+
+> «Проверь, есть ли ошибки в этом коде на Tolk — мне нужна только быстрая проверка синтаксиса, без полного результата компиляции.»
+
+Ассистент использует `check_tolk_syntax` для более быстрой обратной связи без возврата Fift/BoC.
+
+**Написание нового контракта с нуля:**
+
+> «Напиши простой контракт счётчика для TON, который хранит число и позволяет кому угодно его увеличивать. Добавь геттер для чтения текущего значения.»
+
+Ассистент использует промпт `write_smart_contract`, который внедряет руководство по языку Tolk и релевантный пример, а затем итеративно компилирует, пока контракт не будет без ошибок.
+
+**Ревью существующего контракта:**
+
+> «Проверь этот контракт на проблемы безопасности» *(вставьте код)*
+
+Ассистент использует `review_smart_contract` для проведения структурированного аудита безопасности, охватывающего контроль доступа, управление газом и векторы атак, специфичные для TON.
+
+**Отладка ошибки компиляции:**
+
+> «Я получаю эту ошибку при компиляции: `unexpected token 'fun'` — вот мой код:» *(вставьте код)*
+
+Ассистент использует `debug_compilation_error` для диагностики проблемы на основе справочника языка и предоставления исправления.
+
+**Генерация ссылки для деплоя:**
+
+> «Сгенерируй ссылку для деплоя контракта, который мы только что скомпилировали.»
+
+Ассистент возьмёт BoC из предыдущей компиляции и вызовет `generate_deploy_link` для создания deeplink-а `ton://`, который можно открыть в Tonkeeper или любом кошельке TON.
+
+## Разработка
+
+```bash
+git clone https://github.com/izzzzzi/izTolkMcp.git
+cd iz-tolk-mcp
+npm install          # Установка зависимостей
+npm run build        # Компиляция TypeScript + копирование файлов контента
+npm run dev          # Запуск с tsx (горячая перезагрузка для разработки)
+npm test             # Запуск тестов (vitest)
+```
+
+## Качество кода
+
+Pre-commit хуки автоматически обеспечивают качество кода:
+
+- **Biome** — быстрый линтер и форматтер для TypeScript
+- **Husky** — менеджер Git-хуков
+- **lint-staged** — запускает проверки только для staged-файлов
+
+```bash
+npm run lint          # Проверить на ошибки линтинга
+npm run lint:fix      # Автоматически исправить ошибки линтинга
+npm run format        # Форматировать код с помощью Biome
+```
+
+Pre-commit хук запускает `biome check --write` и `biome format --write` для всех staged `.ts` файлов.
+
+## CI/CD
+
+Проект использует автоматизированный CI/CD:
+
+- **GitHub Actions** — сборка, тестирование и линтинг при каждом push и PR
+- **Semantic Release** — автоматическое версионирование на основе [Conventional Commits](https://www.conventionalcommits.org/):
+  - `feat:` — минорное обновление версии (1.x.0)
+  - `fix:` — патч-обновление версии (1.0.x)
+  - `feat!:` или `BREAKING CHANGE:` — мажорное обновление версии (x.0.0)
+  - `chore:`, `docs:`, `refactor:` — без релиза
+- **Dependabot** — автоматическое еженедельное обновление зависимостей
+
+Релизы публикуются в npm автоматически при пуше изменений в ветку `main`.
+
+## Архитектура
+
+Сервер организован в специализированные модули:
+
+```
+src/
+  index.ts        — Инициализация сервера и stdio-транспорт
+  tools.ts        — 4 MCP-инструмента (компиляция, проверка, версия, деплой)
+  resources.ts    — 6 MCP-ресурсов (документация, примеры)
+  prompts.ts      — 3 MCP-промпта (написание, ревью, отладка)
+  content/        — Встроенная документация и примеры контрактов
+    language-guide.md
+    stdlib-reference.md
+    changelog.md
+    tolk-vs-func.md
+    example-counter.tolk
+    example-jetton.tolk
+```
+
+Ключевые зависимости:
+
+- `@modelcontextprotocol/sdk` — фреймворк MCP-сервера
+- `@ton/tolk-js` — компилятор Tolk (WASM, работает локально)
+- `@ton/core` — примитивы TON для вычисления адресов и сериализации ячеек
+- `zod` — валидация схем для параметров инструментов
+
+## Лицензия
+
+MIT