Human ETH Call MCP Server

这是一个专注于使用Etherscan API进行代币操作和智能合约交互的MCP（模型上下文协议）服务器。

🚀 快速开始

获取免费的Etherscan API密钥：

• 访问：https://etherscan.io/apis
• 创建账户并获取API密钥

🎯 安装方法

对于Cursor IDE

选择以下方法之一将MCP服务器添加到Cursor：

方法1：Docker（推荐）

在你的~/.cursor/mcp.json中添加：

{
  "mcpServers": {
    "human-eth-call": {
      "command": "docker",
      "args": [
        "run","--rm","-i",
        "-e","ETHERSCAN_API_KEY",
        "ghcr.io/git-alice/human_eth_call_mcp:latest"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

方法2：UVX（Python包管理器）

在你的~/.cursor/mcp.json中添加：

{
  "mcpServers": {
    "human-eth-call": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/git-alice/human_eth_call_mcp.git",
        "human-eth-call-mcp"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

方法3：本地安装

git clone https://github.com/git-alice/human_eth_call_mcp.git
cd human_eth_call_mcp
bash scripts/cursor-install-mcp.sh

🔧 可用工具

1. getTokenBalance - 获取任何地址的代币余额
2. getTokenDetails - 获取全面的代币信息（名称、符号、小数位数、总供应量）
3. getContractABI - 获取已验证合约的合约ABI
4. getContractSourceCode - 获取合约源代码
5. executeContractMethod - 执行合约方法，自动编码/解码
6. getContractCreation - 获取合约部署者地址和创建交易哈希（最多5个合约）
7. ethGetTransactionReceipt - 获取单个交易收据，包括状态、gas使用情况和日志
8. ethGetTransactionReceipts - 获取多个交易收据（最多20个交易），包括状态、gas使用情况和日志
9. getEventLogs - 获取事件日志，支持主题过滤（支持事件签名和十六进制主题，可选topic1用于高级过滤，返回最近的例子）
10. getTimestampByBlockNumber - 根据区块号获取UNIX时间戳