EVM MCP Server

🚀 EVM-MCP Server: Ethereum Virtual Machine Multi-Chain Processing Server

The EVM-MCP Server is a powerful tool designed to provide unified management and operations for multiple blockchain networks. It supports various EVM-compatible chains and offers a range of core services.

🚀 Quick Start

To quickly get the EVM-MCP Server up and running, follow the steps below.

📦 Installation

Install Dependencies

Run the following command to install the required dependencies:

npm install

Start the Server

Use the following command to start the server:

node src/index.ts

💻 Usage Examples

Basic Usage

Initial Configuration

Modify the following configuration items in src/server/http-server.ts:

• port: Set the port for the service to listen on. The default is 3000.
• networks: A list of supported blockchain networks, for example: ['ethereum', 'polygon'].

✨ Features

Blockchain Network Support

The current server supports the following networks:

• Ethereum Mainnet
• Polygon Network
• Arbitrum and other EVM-compatible chains

Core Service Components

1. Chain Operations: Provides basic blockchain operations, such as block information query and transaction verification.
2. Token Services: Supports token operations following the ERC20, ERC721, and ERC1155 standards.
3. Contract Interactions: Allows interaction with smart contracts to perform on-chain operations.
4. Transaction Management: Provides functions for transaction broadcasting, status query, and receipt retrieval.

🔧 Technical Details

Security Precautions

• Private Key Management: Private keys are only used for transaction signing, and the server does not store any private keys.
• Authentication: It is recommended to implement additional authentication mechanisms in the production environment.
• HTTPS Deployment: Use HTTPS in the production environment to ensure communication security.
• Rate Limiting: Set rate limits to prevent abuse attacks.
• High-Value Services: It is recommended to add a confirmation step.

Project Structure

mcp-evm-server/
├── src/
│   ├── index.ts                # Entry file for the standard input-output server
│   ├── server/                 # Server-related files
│   │   ├── http-server.ts      # Implementation of the HTTP server with SSE
│   │   └── server.ts           # General server configuration
│   ├── core/
│   │   ├── chains.ts           # Blockchain network definitions and utility functions
│   │   ├── resources.ts        # Implementation of MCP resource interfaces
│   │   ├── tools.ts            # Implementation of the MCP toolset
│   │   ├── prompts.ts          # Implementation of MCP prompts
│   │   └── services/           # Core blockchain services
│   │       ├── index.ts        # Operation export file
│   │       ├── balance.ts      # Fund query service
│   │       ├── transfer.ts     # Token transfer service
│   │       ├── utils.ts        # Collection of utility functions
│   │       ├── tokens.ts       # Token metadata service
│   │       ├── contracts.ts    # Smart contract interaction service
│   │       ├── transactions.ts # Transaction processing service
│   │       ├── blocks.ts       # Block information service
│   │       └── clients.ts      # RPC client tools
├── package.json
├── tsconfig.json
└── README.md

📄 License

This project is licensed under the MIT License. For specific terms, see the LICENSE file.