@sinco Labevm MCP Server

An EVM interaction service gateway based on Model Context Protocol (MCP) and Viem, allowing AI agents or services to securely interact with configured EVM-compatible blockchains.

Finance Developer tools #EVM Gateway #Blockchain Interaction #MCP Protocol #Smart Contracts .TypeScript

rating : 2 points

downloads : 7

update time : 2025-04-23

What is the EVM MCP Server?

The EVM MCP Server is a service gateway that provides interfaces through the Model Context Protocol (MCP), allowing AI agents or other clients to securely interact with EVM-compatible blockchains. It leverages the powerful features of the Viem library to achieve reliable and efficient EVM operations.

How to use the EVM MCP Server?

First, install and configure the server, then connect clients (such as Cursor or Claude) through the MCP interface. The server supports various read and write operations, such as querying balances, sending tokens, and interacting with smart contracts.

Applicable Scenarios

Suitable for applications that require automated interaction with EVM-compatible chains, such as decentralized finance (DeFi), NFT markets, etc.

Main Features

Get Wallet AddressGet the currently connected wallet address.

Get Chain InformationReturn the chain ID and name that the server is connected to.

Query BalanceCheck the local token balance of the specified address.

Sign MessageSign a message using the wallet configured on the server.

Send Native TokensSend native tokens such as ETH from the server wallet to the recipient.

Advantages and Limitations

Advantages

Supports multiple EVM chains

Efficient and stable Viem library

Comprehensive API tool support

Limitations

Requires private key management

Standard configuration files may involve security risks

How to Use

Install Dependencies

Ensure that Node.js version 18.0.0 or higher is installed, and use pnpm to install project dependencies.

Configure Environment Variables

Create a.env file and fill in WALLET_PRIVATE_KEY and RPC_PROVIDER_URL.

Start the Server

Run the built JavaScript file to start the service.

Usage Examples

Query BalanceQuery the ETH balance of the server wallet.

Send ETHSend 1 ETH from the server wallet to another address.

Frequently Asked Questions

How to protect my private key?

Does it support multiple EVM chains?

How to test server functionality?

Related Resources

Official Documentation

Detailed usage guide and technical instructions

GitHub Repository

Source code and Issue tracking

Viem Official Documentation

More information about the Viem library

🚀 Ethereum Virtual Machine Context Protocol (EVMCP) Server

This project offers an Ethereum Virtual Machine Context Protocol (EVMCP) server based on the Ethereum network. The server exposes various tool interfaces, enabling external systems or applications to interact with the Ethereum blockchain.

🚀 Quick Start

Prerequisites

Operating System: Linux or macOS (recommended).
Node.js Version: 16.0.0 or higher.
pnpm Version: 4.0.0 or higher.
Ethereum RPC Node: An available Ethereum JSON - RPC endpoint (e.g., Infura, Alchemy).

Installation and Running

1. Clone the Repository

git clone https://github.com/your-repository/evm-mcp-server.git
cd evm-mcp-server

2. Install Dependencies

pnpm install

3. Create Environment Variable File

Copy the .env.example file and name it .env, then modify the configuration as needed:

cp .env.example .env

Edit the .env file and fill in the following content:

WALLET_PRIVATE_KEY=your-wallet-private-key
RPC_PROVIDER_URL=https://eth-mainnet.alchemyapi.io/v2/your-api-key
DEFAULT_GAS_LIMIT=100000
DEFAULT_GAS_PRICE=200000

4. Compile the Code

pnpm run build

5. Start the Server

pnpm run start

✨ Features

Project Objectives

Provide a reliable and user - friendly interface for interacting with the Ethereum blockchain.
Implement various Ethereum - related operation tools, supporting functions such as address management and token operations.
Offer detailed documentation and sample code for easy integration and use by developers.

Available Tools

The following are all the tools currently supported by the server and their descriptions:

Tool Name	Description
`getAddress`	Get the wallet address connected to the server.
`getChain`	Get the chain ID and chain name that the server is connected to.
`getBalance`	Get the native token balance of a specified address (or the server wallet).
`signTransaction`	Sign a transaction in preparation for sending it to the blockchain.
`sendTransaction`	Send a signed transaction to the blockchain and return the transaction hash.
`deployContract`	Deploy a new smart contract to the blockchain.
`callContract`	Call a method of a smart contract deployed on the blockchain.
`transferEth`	Send Ethereum native tokens (ETH) to a specified address.
`approveToken`	Authorize the server wallet to manage the transfer operations of a certain token.

📚 Documentation

Project Structure

evm-mcp-server/
├── src/                # Core service code
│   ├── evm.ts          # Main server entry logic
│   └── evm-tools.ts    # Definition and implementation of all MCP tools
├── test/               # Test code
│   └── client.ts       # Example test client
├── build/              # Compiled JavaScript code (automatically generated by `pnpm run build`)
├── .env.example        # Example environment variable file
├── .env                # Environment variable configuration file (needs to be created manually and will not be under version control)
├── .gitignore          # Ignored file list
├── package.json        # Project dependencies and scripts
├── pnpm-lock.yaml      # pnpm file
├── tsconfig.json       # TypeScript compiler configuration
└── README.md           # English version description
└── README.zh.md        # Chinese version description

Development Guide

1. Prepare the Development Environment

pnpm run dev

2. Test the Code

pnpm test

3. Debug Logs

pnpm run debug

Document References

Ethereum Yellow Paper: https://ethereum.org/en/whitepaper/
JSON - RPC Standard: https://www.jsonrpc.org/specification
Solidity Programming Language: https://soliditylang.org/

🔧 Technical Details

Security Precautions

Private Key Management: Ensure that the WALLET_PRIVATE_KEY in the .env file is not leaked or committed to the version control system.
RPC Security: Use HTTPS to ensure secure communication with the RPC provider and update the API key regularly.
Permission Control: Limit access permissions to the server endpoints according to actual needs.

📄 License

No license information provided in the original document.

🤝 Contribution Guide

Community contributions are welcome! Please refer to CONTRIBUTING.md to learn how to contribute to this project.

📈 Project Status

Version: v1.0.0
Maintenance Status: Actively maintained
Change Log: Please see CHANGELOG.md

⚠️ Important Note

Ensure that the WALLET_PRIVATE_KEY in the .env file is not leaked or committed to the version control system. Use HTTPS to ensure secure communication with the RPC provider and update the API key regularly. Limit access permissions to the server endpoints according to actual needs.

💡 Usage Tip

You can follow the steps in the development guide to set up the development environment, test the code, and view debug logs during development.

Thank you for your support and use! If you need feedback or assistance, please contact our team at support@evm - mcp - server.com.