Tolk MCP Server

tolk-mcp-server

Tolk スマートコントラクトコンパイラー用の MCP サーバーです。MCP 対応の AI アシスタント（Claude Desktop、Cursor、Windsurf など）から TON スマートコントラクトをコンパイル、検証、調査できます。

機能

ツール:

• get_compiler_version — Tolk コンパイラーのバージョンを返します
• compile_tolk — 最適化レベル、スタックコメント、実験的フラグなど、すべてのコンパイラーオプションを指定して、Tolk ソースコードを Fift + BoC にコンパイルします
• check_tolk_syntax — 出力全体を生成せずに、構文をすばやく検証します

リソース:

• tolk://reference — Tolk 言語のクイックリファレンス（構文、型、FunC との違い）
• tolk://examples/hello-world — カウンターコントラクトの例
• tolk://examples/wallet — ウォレットコントラクトの例
• tolk://examples/jetton — Jetton（トークン）コントラクトのひな形

プロンプト:

• write_smart_contract — 新しい TON スマートコントラクトを作成するためのガイド付きプロンプト
• review_smart_contract — セキュリティレビューと最適化分析のためのガイド付きプロンプト

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します：

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

Cursor / Windsurf

MCP 設定に追加します：

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

ソースから実行

git clone https://github.com/oxgeneral/tolk-mcp-server.git
cd tolk-mcp-server
npm install
npm run build
npm start

使用例

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

> Use the compile_tolk tool to compile this contract:

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

get fun hello(): int {
    return 42;
}

ツールは次の内容を返します：

• Fift アセンブリコード
• BoC（Bag of Cells）の base64 エンコード — デプロイにそのまま使用できます
• コードハッシュ — コンパイル済みコードの一意の識別子
• 警告（ある場合）

構文をすばやく確認する

> Use check_tolk_syntax to validate my contract before deploying

OK とコードハッシュ、または行・列情報を含む詳細なエラーが返されます。

複数ファイルのコントラクト

すべてのファイルを sources パラメーターに渡します：

{
  "entrypointFileName": "main.tolk",
  "sources": {
    "main.tolk": "import \"./utils.tolk\";\nfun onInternalMessage(...) { ... }",
    "utils.tolk": "fun helper(): int { return 1; }"
  }
}

標準ライブラリのインポート（@stdlib/*）は、コンパイラーによって自動的に解決されます。

コンパイラーオプション

オプション	型	デフォルト	説明
optimizationLevel	0-2	2	0 = なし、1 = 基本、2 = 最大
withStackComments	bool	false	Fift 出力にスタックレイアウトのコメントを追加します
experimentalOptions	string	""	スペース区切りの実験的なコンパイラーフラグ

必要条件

• Node.js >= 18
• npm パッケージ以外の外部依存関係はありません

開発

npm install
npm run dev    # Run with tsx (hot reload)
npm run build  # Compile TypeScript
npm test       # Run tests

ライセンス

MIT