Smart-Contract MCP Server Generator

What is Smart-Contract MCP Server Generator?

A chain-agnostic tool that automatically generates typed MCP (Model Context Protocol) servers from smart contract artifacts (ABIs, IDLs, etc.). The generated servers expose smart contract functionality as tools that can be used by Large Language Models (LLMs) through the Model Context Protocol.

How to use Smart-Contract MCP Server Generator?

Install via go install github.com/openhands/mcp-generator/cmd/generate-mcp@latest, then use the CLI with flags such as --artifact, --lang, --chain, and --output. For example, generate-mcp --artifact path/to/abi.json --lang ts --output ./my-mcp-server generates a TypeScript MCP server from an Ethereum ABI.

Key features of Smart-Contract MCP Server Generator

• Generates typed MCP servers from smart contract ABIs/IDLs
• Supports multiple blockchain platforms (Ethereum, Solana, etc.)
• Customizable templates for TypeScript and Python
• CLI tool for easy integration into development workflows
• Chain-agnostic design

Use cases of Smart-Contract MCP Server Generator

• Creating an MCP server for an ERC-20 token to enable LLM balance queries
• Generating Solana program tools for AI assistants
• Rapidly prototyping smart contract interfaces for AI agents

FAQ from Smart-Contract MCP Server Generator

What is MCP?

The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to LLMs. It enables LLMs to securely access tools and data sources through a standardized client-server architecture.

Which blockchain platforms are supported?

The tool currently supports Ethereum, Solana, and other platforms through the use of ABIs and IDLs.

How do I install the CLI?

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

Is this project production-ready?

No, the project is still a work in progress. See the Phase 1 issue for current development status.

How can I test the generated MCP servers?

The project includes end-to-end tests using Playwright and the MCP Inspector. Run cd mcp-tests && npm install && ./run-tests.sh to verify connectivity, tool listing, execution, and error handling.