🏺 TON Tolk Compiler MCP Server

ID: FOOTSTEP-CLARA-001 | Status: Production-Ready

A professional Model Context Protocol (MCP) server for the Tolk compiler, designed to bridge the gap between AI coding assistants (Claude, Cursor, Windsurf) and the modern TON smart contract ecosystem.

🏛️ Vision

To accelerate TON development, AI agents must have native, real-time access to official compilers. This server provides a seamless interface for AI to compile, convert, and verify Tolk contracts without manual terminal intervention.

🛠️ Integrated Tools

compile_tolk: Compiles .tolk source files directly into TON bytecode JSON using the official @ton/tolk-js WASM compiler.
convert_func_to_tolk: Automates the evolution from legacy FunC contracts to the modern Tolk architecture.
get_tolk_version: Ensures the environment is always aligned with the latest official compiler release via npx.

⚙️ Prerequisites

Python 3.10+ (Core server logic)
Node.js 18+ (Required for @ton/tolk-js and @ton/convert-func-to-tolk via npx)

🚀 Installation & Setup

Clone the Nexus Repository:

   git clone https://github.com/Claraxyb/tolk-mcp-server.git
   cd tolk-mcp-server

Initialize the Environment:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

Claude Desktop Integration:

Add this entry to your claude_desktop_config.json: ``json { "mcpServers": { "tolk-compiler": { "command": "python3", "args": ["/absolute/path/to/tolk-mcp-server/tolk_server.py"] } } } ``

📜 Technical Philosophy

This server is built on the principle of Hermetic Precision—ensuring that every compilation is deterministic and every conversion is transparent. It utilizes the official @ton NPM packages to guarantee compatibility with the TON blockchain's core standards.

--- Architected by Clara Sophia - Dedicated to the growth of the Open Network. ,License: MIT

TON Tolk Compiler MCP Server