Crazyrabbitltc MCP Etherscan Server

🚀 Ethereum Etherscan MCP Server

An MCP (Model Context Protocol) server that provides Ethereum blockchain data tools through the Etherscan API. It enables functions such as checking ETH balances, viewing transaction histories, tracking ERC20 token transfers, obtaining smart contract ABIs, monitoring gas prices, and resolving ENS names.

✨ Features

• Balance Inquiry: Retrieve the ETH balance of any Ethereum address.
• Transaction History: View recent transactions with detailed information.
• Token Transfers: Track ERC20 token transfer records and their token details.
• Contract ABI: Obtain the ABI of smart contracts for development purposes.
• Gas Prices: Monitor the current gas prices (safe low, standard, fast).
• ENS Resolution: Resolve Ethereum addresses to ENS names.

📋 Prerequisites

• Node.js >= 18
• Etherscan API key (obtainable at https://etherscan.io/apis)

📦 Installation

1. Clone the repository:

git clone [your-repo-url]
cd mcp-etherscan-server

2. Install dependencies:

npm install

3. Create a .env file in the root directory:

ETHERSCAN_API_KEY=Your_API_Key

4. Build the project:

npm run build

🚀 Quick Start

Start the server:

npm start

The server will run on standard output, making it compatible with MCP clients (e.g., Claude Desktop).

📚 Documentation

This server implements the Model Context Protocol (MCP) and provides tools for interacting with Ethereum blockchain data through the Etherscan API. Each tool is exposed as an MCP endpoint and can be invoked by compatible clients.

Available Tools

1. check-balance

   • Input: Ethereum address
   • Output: ETH balance (in Wei and ETH)

2. get-transactions

   • Input: Ethereum address, optional limit
   • Output: Recent transactions, including timestamps, values, and addresses

3. get-token-transfers

   • Input: Ethereum address, optional limit
   • Output: Recent ERC20 token transfer records and their detailed information

4. get-contract-abi

   • Input: Contract address
   • Output: Contract ABI in JSON format

5. get-gas-prices

   • Input: None
   • Output: Current gas prices (in Gwei)

6. get-ens-name

   • Input: Ethereum address
   • Output: Resolved ENS name if available

💻 Usage Examples

Using with Claude Desktop

Add this server to Claude Desktop:

1. Start the server using npm start.

2. In Claude Desktop:

   • Go to Settings.
   • Navigate to the MCP Server section.
   • Click "Add Server".
   • Enter the following configuration:

     {
       "name": "Etherscan Tools",
       "transport": "stdio",
       "command": "node /path/to/mcp-etherscan-server/build/index.js"
     }
     

   • Save the configuration.

3. Now, the Etherscan tools will be available in Claude conversations.

Example Usage in Claude

You can use commands like the following:

Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e
Or
Show recent transactions for vitalik.eth

🔧 Technical Details

To add new features or modify existing ones:

1. The main server logic is in src/server.ts.
2. The Etherscan API interaction handling is in src/services/etherscanService.ts.
3. After making modifications, build the project: npm run build.

📄 License

This project is under the MIT License - see the LICENSE file for details.