What is Eth Mcp Server

eth-mcp-server is an experimental MCP server designed for Ethereum, providing wallet management, transaction handling, and contract interaction capabilities using FastAPI and Web3.py.

Use cases

Use cases include managing Ethereum wallets, sending and receiving ETH transactions, interacting with smart contracts, and developing dApps that require secure wallet and transaction functionalities.

How to use

To use eth-mcp-server, first install the dependencies, set up the environment variables, and then run the server using the provided commands in the README.

Key features

Key features include wallet management (creating, importing, listing wallets, checking balances), transaction management (sending transactions, getting details, gas estimation), and upcoming features for contract and token management.

Where to use

eth-mcp-server can be used in blockchain development, decentralized application (dApp) development, and any project requiring Ethereum wallet and transaction management.

Ethereum MCP Server

WARNING: THIS REPO IS HIGHLY EXPERIMENTAL AND LIKELY TO NOT WORK AT THIS MOMENT. IT’S UNDER ACTIVE DEVELOPMENT AND WE WILL UPDATE THIS WARNING ONCE IT’S CONSIDERED SAFE TO RUN.

A comprehensive Ethereum MCP server implementation with wallet management, transaction handling, and contract interaction capabilities. Built with FastAPI and Web3.py.

Features

Wallet Management

• Create new wallets
• Import existing wallets
• List managed wallets
• Check ETH balances
• Secure private key handling

Transaction Management

• Send ETH transactions
• Get transaction details
• Get transaction receipts
• Gas estimation
• Nonce management
• Transaction monitoring

Contract Interaction (Coming Soon)

• Deploy contracts
• Call contract methods
• Execute contract transactions
• Contract event listening
• ABI handling

Token Management (Coming Soon)

• ERC20 balance checking
• ERC20 transfers
• NFT metadata retrieval
• NFT transfers
• Token approval management

Advanced Features (Coming Soon)

• EIP-7702 delegation
• Event log retrieval
• Partial withdrawals
• Full withdrawals
• Batch operations

Quick Start

1. Install dependencies:

uv venv
source .venv/bin/activate
uv pip install -e .

2. Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

3. Run the server:

python src/server.py

API Methods

Wallet Methods

Transaction Methods

Development

Project Structure

src/
├── server.py           # Main FastAPI server
├── core/              # Core functionality
│   ├── wallet.py      # Wallet management
│   ├── transaction.py # Transaction handling
│   ├── contract.py    # Contract interaction
│   └── token.py       # Token/NFT handling
├── models/            # Data models
└── utils/             # Utilities

Running Tests

pytest

Code Style

ruff check .
ruff format .

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

MIT