Mcpdotdirect Evm MCP Server

🚀 EVM Server

The EVM (Ethereum Virtual Machine) Server is an extended tool based on the MCP protocol, designed for interacting with the Ethereum blockchain. It supports a variety of functions, including smart contract operations, token management, and transaction processing.

🚀 Quick Start

The EVM Server is an extended tool based on the MCP protocol, enabling seamless interaction with the Ethereum blockchain. It offers a wide range of functions such as smart contract operations, token management, and transaction processing.

📦 Installation

Install Dependencies

Use npm to install the required dependencies:

npm install

Start the Server

Run the main program to start the server:

npm start

📚 Documentation

Configuration Example

Here is a typical server configuration example:

const config = {
  port: 3000,
  networks: ['eth', 'bsc'],
  chains: {
    eth: { providerUrl: 'https://mainnet.infura.io/v3/YOUR_API_KEY' },
    bsc: { providerUrl: 'https://bsc-dataseed1.binance.org' }
  }
};

Feature Overview

Core Features

• Smart Contract Operations: Supports reading and writing the state of smart contracts.
• Token Management: Provides comprehensive support for ERC20, ERC721, and ERC1155 tokens.
• Transaction Processing: Allows sending and receiving native Ethereum tokens and various other tokens.

Advanced Features

• Block Query: Retrieves data for a specified block or the latest block.
• Logging: Provides detailed transaction receipts and event logs.
• Network Support: Supports multiple blockchain networks, such as Ethereum and Binance Smart Chain.

API Documentation

Request Format

All requests are in JSON format:

{
  "method": "eth_getBalance",
  "params": ["0x1234567890123456789012345678901234567890", "latest"],
  "id": 1,
  "jsonrpc": "2.0"
}

Response Format

{
  "jsonrpc": "2.0",
  "result": "0x123",
  "error": null,
  "id": 1
}

Project Structure

Here is the project's directory structure:

mcp-evm-server/
├── src/
│   ├── index.ts                # Main console server entry file
│   ├── server/                 # Server-related files
│   │   ├── http-server.ts      # SSE-based HTTP server
│   │   └── server.ts           # General server settings
│   ├── core/
│   │   ├── chains.ts           # Network definitions and tools
│   │   ├── resources.ts        # MCP resource implementation
│   │   ├── tools.ts            # MCP tool implementation
│   │   ├── prompts.ts          # MCP prompt implementation
│   │   └── utils/              # Helper utility functions
│   │       └── abi_decoder.ts  # ABI decoder
└── package.json               # Project dependencies and scripts

Security Considerations

• Network Isolation: Ensure the separation of the production environment from the development environment.
• Access Control: Configure appropriate CORS and authentication mechanisms.
• Log Monitoring: Monitor server logs in real-time to detect anomalies promptly.

Development Instructions

Contribution Guidelines

Community contributions are welcome! Please follow these steps:

1. Fork the project repository.
2. Create a feature branch.
3. Submit your code and create a Pull Request.

Issue Feedback

If you encounter any issues, please contact the maintenance team at contact@evm-server.com.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.