EVM Blockchain

An EVM - compatible blockchain service MCP server supporting multi - chain interaction, providing a unified blockchain operation interface, supporting more than 30 networks and ENS resolution.

Developer tools Finance #Multi - chain Interaction #Smart Contract #ENS Resolution #Blockchain Service Remote .TypeScript

rating : 3.5 points

downloads : 253

update time : 2025-04-28

What is the EVM MCP Server?

The EVM MCP Server is a tool based on the Model Context Protocol (MCP), which allows AI systems to easily interact with blockchain networks compatible with the Ethereum Virtual Machine (EVM). Whether you need to query balances, send transactions, or interact with smart contracts, this server provides simple and easy-to-use interfaces.

How to use the EVM MCP Server?

You can start using it simply through the command line or HTTP requests. Both developers and AI assistants can quickly get started without in - depth knowledge of underlying blockchain technology.

Applicable Scenarios

It is suitable for application scenarios that require frequent access to data from multiple EVM chains, such as financial applications, decentralized applications (dApps), and blockchain data analysis tools.

Main Features

Multi - chain SupportSupports more than 30 EVM - compatible chains, such as Ethereum, Polygon, Optimism, etc.

Address ResolutionSupports using ENS domain names instead of traditional addresses for operations, such as 'vitalik.eth'.

Smart Contract InteractionCan read and write the smart contract state and even verify the authenticity of the contract.

Token ManagementSupports operations on multiple token types such as ERC20, ERC721, ERC1155.

Advantages and Limitations

Advantages

Unified interface simplifies cross - chain operations

Powerful ENS resolution ability enhances user experience

Highly modular design facilitates the expansion of new functions

Limitations

Requires a certain level of security for private key storage

May not perform well for extremely high - throughput requirements

How to Use

Install Dependencies

Ensure that Bun or Node.js is installed, and then run the following command to install project dependencies: ```bash bun install ```

Start the Server

Running the server locally can be done through the following command: ```bash bun start ```

Test the Connection

Use the MCP Inspector or other clients to check if the server is working properly.

Usage Examples

Query ETH BalanceGet the user's ETH balance by entering the ENS name.

Deploy a Smart ContractUpload and deploy a new smart contract to the specified network.

Frequently Asked Questions

How to solve the problem that the server cannot start?

Does it support custom chains?

Related Resources

Official Documentation

Detailed user guides and technical documentation.

GitHub Repository

Source code and contribution guidelines.

🚀 EVM Server

This document introduces the functions, structure, and usage of the EVM (Ethereum Virtual Machine) server. The server supports multiple blockchain networks and provides a wealth of resource interfaces and tools.

🚀 Quick Start

Installation

Install dependencies: npm install
Start the server: npm run dev
Debugging tool: Use ts-node for module debugging

Configuration Files

config/chains.ts: Define the configuration of supported blockchain networks.
config/secrets.ts: Store sensitive information, such as API keys.

✨ Features

Blockchain Data: Supports querying chain information, block data, transaction records, etc., of multiple blockchain networks.
Token Interaction: Supports functions such as balance query and transfer of ERC20, ERC721, and ERC1155 tokens.
Smart Contracts: Provides the ability to read and write smart contracts and supports ABI interface calls.
ENS Resolution: Supports resolving ENS names to addresses.
Tools and Resources: Provides various blockchain development tools and resource interfaces.

📦 Project Structure

mcp-evm-server/
├── src/
│   ├── index.ts                # Main standard input-output server entry file
│   ├── server/                 # Server-related files
│   │   ├── http-server.ts      # HTTP server implementation with SSE
│   │   └── server.ts           # General server settings
│   ├── core/
│   │   ├── chains.ts           # Chain definitions and utility functions
│   │   ├── resources.ts        # MCP resource implementation
│   │   ├── tools.ts            # MCP tool implementation
│   │   ├── prompts.ts          # MCP prompt implementation
│   │   └── services/           # Core blockchain services
│   │       ├── index.ts        # Operation exports
│   │       ├── balance.ts      # Balance service
│   │       ├── transfer.ts     # Token transfer service
│   │       ├── utils.ts        # Utility functions
│   │       ├── tokens.ts       # Token metadata service
│   │       ├── contracts.ts    # Contract interaction service
│   │       ├── transactions.ts # Transaction service
│   │       └── blocks.ts       # Block service
│   │       └── clients.ts      # RPC client tools
├── package.json
├── tsconfig.json
└── README.md

📚 Documentation

Blockchain Resource URI Patterns

Resource URI Pattern	Description
`evm://{network}/chain`	Chain information for a specific network
`evm://chain`	Chain information for the Ethereum mainnet
`evm://{network}/block/{blockNumber}`	Block data queried by number
`evm://{network}/block/latest`	Latest block data
`evm://{network}/address/{address}/balance`	Query the native token balance of an address
`evm://{network}/tx/{txHash}`	Transaction details query
`evm://{network}/tx/{txHash}/receipt`	Transaction receipt and logs

Token Resource URI Patterns

Resource URI Pattern	Description
`evm://{network}/token/{tokenAddress}`	ERC20 token information
`evm://{network}/token/{tokenAddress}/balanceOf/{address}`	Query the ERC20 token balance of a specified address
`evm://{network}/token/{tokenAddress}/nft/{tokenId}`	Query the NFT information of a specified tokenId
`evm://{network}/token/{tokenAddress}/metadata`	Get token metadata
`evm://{network}/token/{tokenAddress}/transfer`	Send ERC20 tokens

🔧 Technical Details

Core Tool Classes

ChainManager: Manages the connections and configurations of multiple blockchain networks.
TxBuilder: A transaction builder that supports various on-chain operations.
ContractCaller: A smart contract calling tool that supports ABI interfaces.

Token Tool Classes

TokenBalanceQuery: Used to query token balances.
TokenTransfer: Implements the token transfer function.
NFTManager: Manages NFT assets and supports operations such as mint and burn.

Security Precautions

Private Key Security: All private key operations must be performed in a trusted environment. Do not store or transmit private keys in plain text.
Network Isolation: Strictly isolate the production environment from the test environment to prevent data leakage.
Permission Control: Implement strict permission verification for sensitive operations.
Monitoring and Auditing: Deploy a real-time monitoring and auditing system to record all key operations.