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 汇编代码
• Base64 格式的 BoC（单元包）——可直接用于部署
• 代码哈希——已编译代码的唯一标识符
• 警告（如有）

快速检查语法

> 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