关键词

以太坊区块链浏览器EtherscanWeb3DeFi数据

MCP Etherscan Server 使用说明

项目简介

MCP Etherscan Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它利用 Etherscan API 提供了访问以太坊区块链数据的能力。通过此服务器，LLM 应用可以便捷地获取以太坊网络上的各种信息，例如账户余额、交易历史、代币转移情况、合约 ABI 以及 Gas 价格等。

主要功能点

  • ETH 余额查询: 查询指定以太坊地址的 ETH 余额。
  • 交易历史查询: 获取指定以太坊地址的最新交易记录。
  • 代币转移查询: 查询指定以太坊地址的 ERC20 代币转移记录。
  • 合约 ABI 查询: 获取指定以太坊智能合约的 ABI (应用程序二进制接口)。
  • Gas 价格查询: 获取当前以太坊网络的 Gas 价格信息。
  • ENS 名称解析: 将以太坊地址解析为对应的 ENS 域名。

安装步骤

  1. 克隆仓库 
    git clone https://github.com/5ajaki/mcp-etherscan-server.git
cd mcp-etherscan-server
  2. 安装依赖 
    npm install
  3. 配置 Etherscan API 密钥
    • 在项目根目录下创建 '.env' 文件。
    • 编辑 '.env' 文件，填入您在 Etherscan 申请的 API 密钥。您可以在 Etherscan API 官网 注册并获取 API 密钥。 
      ETHERSCAN_API_KEY=YOUR_API_KEY
  4. 构建项目 
    npm run build

服务器配置

对于 MCP 客户端，您需要配置连接到 MCP Etherscan Server 的信息。以下是一个典型的 JSON 配置示例，适用于使用 'stdio' 传输协议的客户端，例如 Claude Desktop：

{
  "name": "Etherscan Tools",  //  服务器名称，用户自定义，方便在客户端中识别
  "transport": "stdio",     //  指定使用标准输入输出流进行通信
  "command": "node /path/to/mcp-etherscan-server/build/index.js" //  启动服务器的命令，指向构建后的 index.js 文件，需要替换为实际路径
}

注意: 请将 'command' 字段中的 '/path/to/mcp-etherscan-server/build/index.js' 替换为您 'mcp-etherscan-server' 项目在您本地文件系统中的 绝对路径。

基本使用方法

  1. 启动 MCP Etherscan Server 在项目根目录下，运行以下命令启动服务器：

    npm start

    服务器将在后台运行，并通过 'stdio' 准备接收来自 MCP 客户端的请求。

  2. 在 MCP 客户端中使用

    • 打开您的 MCP 客户端（如 Claude Desktop），进入 MCP 服务器配置页面。
    • 点击 "添加服务器" 或类似按钮，根据客户端的指引，填入上面提供的 JSON 配置信息。
    • 保存配置后，MCP 客户端应该能够检测到并连接到 MCP Etherscan Server。
    • 现在，您可以通过 MCP 客户端，以自然语言指令调用 Etherscan Tools 提供的各项功能，例如： 
      查询地址 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 的 ETH 余额
      或 
      显示 vitalik.eth 的最新交易记录
    • MCP 客户端会将这些自然语言指令转换为对 MCP 服务器特定工具的调用，并将结果返回给您。

信息

分类

网页与API

访问项目