EVM Blockchain

🚀 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

1. Install dependencies: npm install
2. Start the server: npm run dev
3. 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

Token Resource URI Patterns

🔧 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

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

📄 Glossary

• EVM: Ethereum Virtual Machine, the environment for running smart contracts.
• ERC20: A token standard based on Ethereum.
• ERC721: An NFT standard protocol.
• ERC1155: A multi-token standard protocol.
• SSE: Server-Sent Events, used for real-time communication.

📄 License

This project is licensed under the MIT License.