Iz Tolk MCP

Z-tolk-mcp

Tolk智能合约编译器的MCP服务器——从任何AI助手编译、检查和部署TON区块链智能合约

 ](https://www.npmjs.com/package/iz-tolk-mcp) ](https://www.npmjs.com/package/iz-tolk-mcp)   ](https://nodejs.org/)

🇷🇺 俄语 | 🇬🇧 英语

*MCP服务器，带来 托尔金 智能合约编译器直接集成到像Claude这样的人工智能助手中——编写、编译、检查和部署TON合约，而无需离开对话。*

______________________________________________________________________

📖 概述

Z-tolk-mcp 是一个 模型上下文协议 （MCP）服务器，将Tolk智能合约编译器集成到AI助手中，为TON区块链开发提供无缝的写-编译-部署工作流。

• 托尔金 是TON区块链的下一代智能合约语言，被设计为FunC的现代继承者，具有熟悉的语法（类似于C/TypeScript）、类型安全和更清晰的语义。
• 主控程序 （模型上下文协议）是一个开放标准，允许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客户端配置

Claude Desktop

添加 claude_desktop_config.json:

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

Claude Code

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

Cursor

添加 .cursor/mcp.json:

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

Windsurf

添加 ~/.windsurf/mcp.json:

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

VS Code (Copilot)

添加 .vscode/mcp.json:

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

Local build (any client)

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

______________________________________________________________________

🛠️ MCP工具

🔍 get_compiler_version

返回捆绑在中的Tolk编译器的版本 @ton/tolk-js （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智能合约：” ``tolk import "@stdlib/tvm-dicts"; fun onInternalMessage(myBalance: int, msgValue: int, msgFull: cell, msgBody: slice) { // handle messages } ``

从头开始写一份新合同：

“为TON编写一个简单的计数器合约，存储一个数字并允许任何人递增它。包括一个getter来读取当前值。”

审查现有合同：

“审查本合同的安全问题” *（粘贴代码）*

调试编译错误：

“我在编译时遇到了这个错误： 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

预提交钩子会自动强制执行代码质量：

• 生物群系 --TypeScript的快速linter和格式化程序
• 哈士奇 --Git挂钩管理器
• 皮棉上演 --仅对暂存文件运行检查