mcpField
E
eth-mcp-server

eth-mcp-server

Local
github.com/qingfengzxrFinance0Updated 81w ago
Repository

About eth-mcp-server

eth-mcp-server provides Ethereum data tools and resources for AI assistants. It covers balances, prices, gas, blocks, transactions, fee estimates, and account history.

Key features

  1. 01Check ETH balances
  2. 02Get ETH price and gas rates
  3. 03Retrieve latest block details
  4. 04View transaction details
  5. 05Estimate transaction fees
  6. 06Query account history

Use cases

  1. 01Check an Ethereum address balance
  2. 02Review current network gas prices
  3. 03Inspect a transaction or latest block
  4. 04Look up an account's transaction history

MCP support

It exposes Ethereum blockchain capabilities to MCP clients through tools and resources, including address, price, network statistics, and transaction information.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

eth-mcp-server

An ETH-obsessed MCP Server, where the creator is still pondering its ultimate usage. For now, it's just for fun!

About MCP

The Model Context Protocol (MCP) allows AI models to access real-time data and perform actions through standardized tools and resources. This implementation provides Ethereum blockchain capabilities to AI assistants through the MCP framework.

Features

Now is support tools & resources

  • Get ETH balance for any Ethereum address
  • Check current Ethereum price in USD
  • Get current gas prices on the Ethereum network
  • Retrieve latest block information
  • View transaction details
  • Estimate transaction fees
  • Query account transaction history

Requirements

  • Python 3.7+
  • web3.py
  • requests
  • mcp.server.fastmcp

Setup

  1. Clone the repository
  2. Install required dependencies: 
    pip install web3 requests
pip install mcp mcp[cli]
pip install uv
  3. Replace the Etherscan API key in the code with your own: 
    ETHERSCAN_API_KEY = "YOUR_API_KEY_HERE"
Available Tools
  • get_eth_balance(address) - Get the ETH balance of an address
  • get_eth_price() - Get current Ethereum price in USD
  • get_gas_price() - Get current Ethereum network gas price
  • get_latest_block() - Get latest block information
  • get_transaction(tx_hash) - Get transaction details
  • estimate_tx_fee(gas_amount) - Estimate transaction fee
  • get_account_transactions(address, page, offset) - Get account transaction history
Available Resources
  • ethereum://price - Ethereum price information
  • ethereum://stats - Ethereum network statistics
  • ethereum://address/{address} - Address information
  • ethereum://address/{address}/transactions - Address transaction history

API Endpoints

The service uses the following external APIs:

  • Ethereum JSON-RPC API via LlamaRPC
  • CoinGecko API for ETH price
  • Etherscan API for transaction history

How to setup with cursor

  1. open cursor mcp setting README image

  2. click Add new Global mcp server button README image

  3. set config like this, please replace the path with you own path README image

{
  "mcpServers": {
    "eth": {
      "type": "stdio",
      "command": "/path/to/python /path/to/blockchain.py"
    }
  }
}
  1. Once you have successfully set up, you can retrieve ETH information in Cursor by using chat.

example

README image

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.