Ethers Wallet

🚀 MCP EVM Server Documentation

MCP EVM Server is a powerful tool for interacting with the Ethereum blockchain. It supports various ERC standard tokens (ERC20, ERC721, and ERC1155) and core wallet operations. By using the MCP protocol, developers can easily integrate with the blockchain.

🚀 Quick Start

Initial Configuration

Create a config.json file and add the following content:

{
  "networks": {
    "mainnet": {
      "providerUri": "https://eth-mainnet.g.alchemy.com/v2/your-api-key",
      "isDefault": true
    },
    "ropsten": {
      "providerUri": "https://eth-ropsten.g.alchemy.com/v2/your-api-key"
    }
  },
  "caching": {
    "ttl": 3600,
    "enabled": true
  },
  "rateLimiting": {
    "windowMs": 1000,
    "maxRequests": 100
  }
}

✨ Features

Supported ERC Standards

• ERC20: Handle standard token operations.
• ERC721: Manage NFT assets.
• ERC1155: Support multi-tokens and batch transfers.

Wallet Functions

• Generate a new wallet address.
• Check wallet balance.
• Import an existing wallet.
• Backup wallet keys.

📦 Installation

Install using npm

Run the following command in your project directory:

npm install mcp-evm-server

💻 Usage Examples

Get Network Information

{
  "name": "getSupportedNetworks",
  "arguments": {}
}

Query Wallet Balance

{
  "name": "getWalletBalance", 
  "arguments": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "provider": "mainnet"
  }
}

Query ERC20 Token Information

{
  "name": "erc20GetTokenInfo",
  "arguments": {
    "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", 
    "provider": "mainnet"
  }
}

📚 Documentation

Configuration Options

Network Configuration

• providerUri: RPC address of Alchemy or Infura.
• isDefault: Set this network as the default.

Caching Configuration

• ttl: Cache expiration time (in seconds).
• enabled: Whether to enable caching.

Rate Limiting Configuration

• windowMs: Rate limiting window time (in milliseconds).
• maxRequests: Maximum allowed requests.

🔧 Technical Details

Tutorial

Step 1: Install Dependencies

Run the following command:

npm install mcp-evm-server

Step 2: Initialize the Configuration File

Create config.json and add network configuration.

Step 3: Start the Server

Start the MCP EVM service using the following command:

npx mcp-evm-server config.json

Extended Reading

• MCP Protocol Documentation
• ERC Standard Token Guide

⚠️ Important Note

• Private Key Management: Avoid storing private keys in the front-end or unencrypted storage.
• API Key Usage: Ensure that the API keys of Alchemy and Infura are not exposed.
• Signature Operations: Use a reliable signature mechanism for sensitive operations (such as token transfers).

By following the above steps, you can easily integrate the MCP EVM Server into your blockchain project. For further assistance, please refer to the full documentation or contact the support team.