iz-tolk-mcp — Tolk Compiler for TON

📖 概要

iz-tolk-mcpは、スマートコントラクトコンパイラーのTolkをAIアシスタントに統合するModel Context Protocol（MCP）サーバーです。TON ブロックチェーン開発における、スムーズな作成・コンパイル・デプロイのワークフローを実現します。

• TolkはTON ブロックチェーン向けの次世代スマートコントラクト言語です。FunCの後継として設計されており、使い慣れた構文（C／TypeScript風）、型安全性、明確なセマンティクスを備えています。
• MCP（Model Context Protocol）は、AIアシスタントが外部ツールを使用したり、データソースにアクセスしたり、ガイド付きワークフローに従ったりできるようにするオープン標準です。これにより、AIアシスタントを有能な開発環境として活用できます。

✨ 機能

🚀 クイックスタート

npx iz-tolk-mcp

サーバーはstdio経由で通信し、MCP クライアントによって起動されるように設計されています。

📦 インストール

npxを使用（インストール不要）

MCP クライアントがサーバーを自動的に起動します。設定に追加するだけです（以下を参照）。

グローバルインストール

npm install -g iz-tolk-mcp

ソースからインストール

git clone https://github.com/izzzzzi/izTolkMcp.git
cd izTolkMcp
npm install
npm run build

要件： Node.js >= 18

🔧 MCP クライアントの設定

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

claude mcp add tolk -- npx -y iz-tolk-mcp

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

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

{
  "servers": {
    "tolk": {
      "command": "npx",
      "args": ["-y", "iz-tolk-mcp"]
    }
  }
}

{
  "mcpServers": {
    "tolk": {
      "command": "node",
      "args": ["/absolute/path/to/izTolkMcp/dist/cli.js"]
    }
  }
}

🛠️ MCP ツール

🔍 get_compiler_version

@ton/tolk-js にバンドルされている Tolk コンパイラー（WASM）のバージョンを返します。

🔨 compile_tolk

Tolk スマートコントラクトのソースコードをコンパイルします。Fift 出力、base64 形式の BoC（Bag of Cells）、コードハッシュ、コンパイラーバージョンを返します。

✅ check_tolk_syntax

Tolk ソースコードの構文エラーと型エラーを、コンパイル出力全体を返さずにチェックします。反復的な開発で、より素早くフィードバックを得られます。

🔗 generate_deploy_link

コンパイル済みコントラクトの TON デプロイ用ディープリンクを生成します。決定論的なコントラクトアドレスを計算し、ウォレットからのデプロイに使用できる ton:// リンクと Tonkeeper リンクを返します。

📄 MCP リソース

💬 MCP プロンプト

write_smart_contract

TON 上で新しい Tolk スマートコントラクトを作成するためのガイド付きワークフローです。言語リファレンスと関連するコントラクトの例を、会話のコンテキストに挿入します。

review_smart_contract

セキュリティに重点を置いた Tolk スマートコントラクトのレビューです。アクセス制御、メッセージ処理、整数オーバーフロー、ガス管理、ストレージの整合性、TON 固有の脆弱性をチェックします。

debug_compilation_error

Tolk のコンパイルエラーを診断して修正します。言語リファレンスに照らしてエラーを分析し、修正済みのコードを提示します。

💡 使用例

設定が完了したら、AI アシスタントで自然言語を使って Tolk MCP サーバーを操作できます。

コントラクトをコンパイルする：

「この Tolk スマートコントラクトをコンパイルしてください：」

import "@stdlib/tvm-dicts";

fun onInternalMessage(myBalance: int, msgValue: int, msgFull: cell, msgBody: slice) {
    // handle messages
}

新しいコントラクトをゼロから作成する：

「TON 用のシンプルなカウンターコントラクトを書いてください。数値を保存し、誰でもインクリメントできるようにしてください。現在の値を読み取るゲッターも含めてください。」

既存のコントラクトをレビューする：

「このコントラクトのセキュリティ上の問題をレビューしてください」 (コードを貼り付けます)

コンパイルエラーをデバッグする：

「コンパイル時にこのエラーが出ます：unexpected token 'fun' — コードはこちらです：」 (コードを貼り付けます)

デプロイリンクを生成する：

「先ほどコンパイルしたコントラクトのデプロイリンクを生成してください。」

📁 プロジェクト構成

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

主な依存関係：

• @modelcontextprotocol/sdk — MCP サーバーのフレームワーク
• @ton/tolk-js — Tolk コンパイラー（WASM、ローカルで実行）
• @ton/core — アドレス計算とセルのシリアライズに使う TON のプリミティブ
• zod — ツールパラメーターのスキーマ検証

🧑‍💻 開発

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)
npm run lint         # Check for lint errors
npm run lint:fix     # Fix lint errors automatically
npm run format       # Format code with Biome

コミット前フックによって、コード品質が自動的に保たれます。

• Biome — TypeScript 用の高速なリンター兼フォーマッター
• Husky — Git フックマネージャー
• lint-staged — ステージング済みのファイルのみを対象にチェックを実行