什么是Smart-Contract MCP Server Generator?

这是一个链无关的工具，能够从智能合约的ABI/IDL等文件自动生成符合MCP协议的服务器。生成的服务器将智能合约的功能暴露为标准化工具，使大型语言模型(LLM)可以通过Model Context Protocol安全地调用这些功能。

如何使用MCP服务器生成器?

只需提供智能合约的ABI/IDL文件，选择目标语言(如TypeScript/Python)，工具就会生成完整的MCP服务器代码。生成的服务器可以立即与支持MCP协议的客户端(如Claude Desktop)集成使用。

适用场景

当您希望让AI助手直接与智能合约交互时；当需要为多个合约快速创建标准化接口时；当需要为LLM提供可编程的区块链访问能力时。

主要功能

多链支持支持Ethereum、Solana等多种区块链平台的智能合约

类型安全生成的服务器代码包含完整的类型定义，确保调用安全

可定制模板支持不同编程语言的输出模板，满足各种集成需求

优势与局限性

优势

自动化生成：无需手动编写接口代码

标准化协议：兼容所有MCP客户端

跨平台：支持多种区块链和编程语言

局限性

目前仍在开发阶段(Work in Progress)

需要提供完整的合约ABI/IDL

高级定制需要Go语言知识

如何使用

安装工具

通过Go命令安装生成器工具

准备合约文件

获取智能合约的ABI(以太坊)或IDL(Solana)文件

生成服务器

运行生成命令指定输入文件和输出目录

启动服务器

进入输出目录并启动生成的MCP服务器

使用案例

查询ERC20代币余额让AI助手查询特定地址的ERC20代币余额

调用拍卖合约通过AI参与Solana上的NFT拍卖

常见问题

MCP是什么？为什么需要它？

生成的服务器如何保证安全性？

支持哪些编程语言？

🚀 智能合约MCP服务器生成器

本工具能够为任意已部署的智能合约，自动生成带有类型定义的MCP（模型上下文协议）服务器，为大型语言模型调用智能合约功能提供便利。

🚀 快速开始

此项目仍在开发中 🐶。该项目提供了一个与区块链无关的工具，可依据智能合约的artifacts（如ABI、IDL等）自动生成MCP服务器。生成的服务器会通过Model Context Protocol将智能合约的功能以工具形式暴露出来，供大型语言模型 (LLMs) 使用。

✨ 主要特性

可从智能合约 ABI/IDL 自动生成带类型定义的 MCP 服务器。
支持包括Ethereum、Solana等在内的多种区块链平台。
提供不同编程语言的可自定义模板。
带有CLI工具，方便集成到开发工作流中。

📦 安装指南

go install github.com/openhands/mcp-generator/cmd/generate-mcp@latest

💻 使用示例

基础用法

# 从 Ethereum ABI 生成 TypeScript MCP 服务器
generate-mcp --artifact path/to/abi.json --lang ts --output ./my-mcp-server

# 从 Solana IDL 生成 Python MCP 服务器
generate-mcp --artifact path/to/idl.json --chain solana --lang python --output ./my-mcp-server

高级用法

# 当前用于测试的命令
go run cmd/generate-mcp/main.go -a examples/erc20.json --name "ERC20 Token" --address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

# 进入测试目录
cd mcp-tests

# 安装依赖项
npm install

# 执行测试
./run-tests.sh

测试使用Playwright自动化与MCP Inspector UI的交互，并验证以下内容：