内容
# Etherscan MCP Server
一个模型上下文协议(Model Context Protocol,MCP)服务器,提供通过 Etherscan API 查询以太坊区块链数据的工具。该服务器使得像 Claude 这样的 AI 助手能够与以太坊区块链数据进行交互,包括账户余额、交易、智能合约和代币信息。
## 特性
- **账户操作**:获取 ETH 余额、交易列表和 ERC20/ERC721 代币转账
- **合约信息**:检索合约 ABI、源代码和执行状态
- **区块数据**:访问区块奖励、交易数量和时间戳
- **代币分析**:查询代币供应、余额和持有者信息
- **事件日志**:搜索和过滤区块链事件日志
- **多链支持**:支持以太坊主网和测试网
## 安装
```bash
npm install @aura/etherscan-mcp
```
## 使用
### CLI 服务器(推荐)
直接使用 npx 运行 MCP 服务器:
```bash
npx @aura/etherscan-mcp
```
这将启动一个基于标准输入输出的 MCP 服务器,可以与 Claude Desktop 或其他 MCP 客户端一起使用。
### Claude Desktop 配置
将以下内容添加到你的 Claude Desktop 配置中:
```json
{
"mcpServers": {
"etherscan": {
"command": "npx",
"args": ["-y", "@aurracloud/etherscan-mcp"],
"env": {
"ETHERSCAN_API_KEY": "ETHERSCAN_API_KEY_GOES_HERE"
}
}
}
}
```
### 编程使用
```typescript
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { registerEtherscanMcpTools } from "@aura/etherscan-mcp";
const server = new McpServer({
name: "etherscan-server",
version: "1.0.0"
}, {
capabilities: {
tools: {},
},
});
// 注册 Etherscan 工具
registerEtherscanMcpTools(server);
// 创建传输并连接
const transport = new StdioServerTransport();
await server.connect(transport);
```
### 环境变量
设置你的 Etherscan API 密钥:
```bash
export ETHERSCAN_API_KEY=your_api_key_here
```
## 可用工具
### 账户工具
- `ETHERSCAN_getEthBalance` - 获取地址的 ETH 余额
- `ETHERSCAN_getEthBalanceMulti` - 获取多个地址的 ETH 余额
- `ETHERSCAN_getListOfTxs` - 获取地址的交易列表
- `ETHERSCAN_getErc20TransfersByAddress` - 获取 ERC20 代币转账
### 合约工具
- `ETHERSCAN_getContractABI` - 获取合约 ABI
- `ETHERSCAN_getContractSourceCode` - 获取合约源代码
- `ETHERSCAN_getContractExecutionStatus` - 获取交易执行状态
### 区块工具
- `ETHERSCAN_getBlockAndUncleRewardByBlockNo` - 获取区块奖励
### 代币工具
- `ETHERSCAN_getErc20TokenSupply` - 获取 ERC20 代币总供应量
- `ETHERSCAN_getErc20TokenBalance` - 获取地址的 ERC20 代币余额
- `ETHERSCAN_getTokenHolderList` - 获取代币持有者列表
### 日志工具
- `ETHERSCAN_getEventLogsByAddress` - 获取地址的事件日志
## 链支持
该服务器支持多个以太坊网络:
- 以太坊主网 (chainId: 1)
- Goerli 测试网 (chainId: 5)
- Sepolia 测试网 (chainId: 11155111)
## API 密钥
你需要一个 Etherscan API 密钥才能使用此服务器。可以在 [etherscan.io/apis](https://etherscan.io/apis) 免费获取一个。
## 许可证
MIT
## 贡献
欢迎贡献!请随时提交 Pull Request。
## 支持
如有问题和疑问,请使用 [GitHub Issues](https://github.com/aura/etherscan-mcp/issues) 页面。