MCP cover image
See in Github
2025-01-01

通过Etherscan的API提供以太坊区块链数据工具的MCP(模型上下文协议)服务器。功能包括检查ETH余额,查看交易历史记录,跟踪ERC20转移,获取合同ABIS,监视汽油价格以及解决ENS名称。

1

Github Watches

9

Github Forks

13

Github Stars

MCP Etherscan Server

An MCP (Model Context Protocol) server that provides Ethereum blockchain data tools via Etherscan's API. Features include checking ETH balances, viewing transaction history, tracking ERC20 transfers, fetching contract ABIs, monitoring gas prices, and resolving ENS names.

Features

  • Balance Checking: Get ETH balance for any Ethereum address
  • Transaction History: View recent transactions with detailed information
  • Token Transfers: Track ERC20 token transfers with token details
  • Contract ABI: Fetch smart contract ABIs for development
  • Gas Prices: Monitor current gas prices (Safe Low, Standard, Fast)
  • ENS Resolution: Resolve Ethereum addresses to ENS names

Prerequisites

Installation

  1. Clone the repository:
git clone [your-repo-url]
cd mcp-etherscan-server
  1. Install dependencies:
npm install
  1. Create a .env file in the root directory:
ETHERSCAN_API_KEY=your_api_key_here
  1. Build the project:
npm run build

Running the Server

Start the server:

npm start

The server will run on stdio, making it compatible with MCP clients like Claude Desktop.

How It Works

This server implements the Model Context Protocol (MCP) to provide tools for interacting with Ethereum blockchain data through Etherscan's API. Each tool is exposed as an MCP endpoint that can be called by compatible clients.

Available Tools

  1. check-balance

    • Input: Ethereum address
    • Output: ETH balance in both Wei and ETH
  2. get-transactions

    • Input: Ethereum address, optional limit
    • Output: Recent transactions with timestamps, values, and addresses
  3. get-token-transfers

    • Input: Ethereum address, optional limit
    • Output: Recent ERC20 token transfers with token details
  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: Associated ENS name if available

Using with Claude Desktop

To add this server to Claude Desktop:

  1. Start the server using npm start

  2. In Claude Desktop:

    • Go to Settings
    • Navigate to the MCP Servers 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. The Etherscan tools will now be available in your Claude conversations

Example Usage in Claude

You can use commands like:

Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

or

Show me recent transactions for vitalik.eth

Development

To add new features or modify existing ones:

  1. The main server logic is in src/server.ts
  2. Etherscan API interactions are handled in src/services/etherscanService.ts
  3. Build after changes: npm run build

License

MIT License - See LICENSE file for details

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • Bora Yalcin
  • Evaluator for marketplace product descriptions, checks for relevancy and keyword stuffing.

  • https://jgadvisorycpa.com
  • This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Alexandru Strujac
  • Efficient thumbnail creator for YouTube videos

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • 发现市场上最全面,最新的MCP服务器集合。该存储库充当集中式枢纽,提供了广泛的开源和专有MCP服务器目录,并提供功能,文档链接和贡献者。

  • ShrimpingIt
  • MCP系列GPIO Expander的基于Micropython I2C的操作,源自ADAFRUIT_MCP230XX

  • OffchainLabs
  • 进行以太坊的实施

  • modelcontextprotocol
  • 模型上下文协议服务器

  • huahuayu
  • 统一的API网关,用于将多个Etherscan样区块链Explorer API与对AI助手的模型上下文协议(MCP)支持。

  • Mintplex-Labs
  • 带有内置抹布,AI代理,无代理构建器,MCP兼容性等的多合一桌面和Docker AI应用程序。

    Reviews

    3 (1)
    Avatar
    user_ycrBlETx
    2025-04-15

    As a dedicated user of the MCP SQLite Server by jparkerweb, I am thoroughly impressed by its seamless integration and performance. The server is incredibly efficient, reliable, and easy to set up, making it perfect for both beginners and advanced users. The support and documentation are top-notch, ensuring smooth deployment and usage. Highly recommended for anyone seeking a robust SQLite server solution!