使用说明
MCP以太网扫描服务器
MCP(模型上下文协议)服务器,通过Etherscan的API提供以太坊区块链数据工具。功能包括检查ETH余额、查看交易历史、跟踪ERC20转账、获取合约ABI、监控天然气价格和解析ENS名称。
特性
- 余额检查:获取任何以太坊地址的ETH余额
- 交易历史记录:查看最近交易的详细信息
- 代币转移:使用代币详细信息跟踪ERC20代币转移
- ABI合同:获取智能合约ABI进行开发
- 天然气价格:监控当前天然气价格(安全低、标准、快速)
- ENS 分辨率:将以太坊地址解析为ENS名称
先决条件
- Node.js>=18
- Etherscan API密钥(在https://etherscan.io/apis)
安装
- 克隆存储库:
git clone [your-repo-url]
cd mcp-etherscan-server
- 安装依赖项:
npm install
- 创建一个
.env根目录中的文件:
ETHERSCAN_API_KEY=your_api_key_here
- 构建项目:
npm run build
运行服务器
启动服务器:
npm start
服务器将在stdio上运行,使其与Claude Desktop等MCP客户端兼容。
运作原理
该服务器实现模型上下文协议(MCP),通过Etherscan的API提供与以太坊区块链数据交互的工具。每个工具都作为MCP端点公开,兼容的客户端可以调用该端点。
可用工具
-
check-balance- 输入:以太坊地址
- 输出:Wei和ETH的ETH余额
-
get-transactions- 输入:以太坊地址,可选限制
- 输出:带有时间戳、值和地址的最近交易
-
get-token-transfers- 输入:以太坊地址,可选限制
- 输出:最近的ERC20代币转移,包括代币详细信息
-
get-contract-abi- 输入:合同地址
- 输出:JSON格式的合约ABI
-
get-gas-prices- 输入:无
- 产量:桂目前的天然气价格
-
get-ens-name- 输入:以太坊地址
- 输出:相关ENS名称(如果可用)
与Claude Desktop一起使用
要将此服务器添加到Claude Desktop,请执行以下操作:
-
使用启动服务器
npm start -
在克劳德桌面中:
- 转到“设置”
- 导航到MCP服务器部分
- 点击“添加服务器”
- 输入以下配置:
{ "name": "Etherscan Tools", "transport": "stdio", "command": "node /path/to/mcp-etherscan-server/build/index.js" } - 保存配置
-
Etherscan工具现在可以在您的Claude对话中使用
Claude中的示例用法
您可以使用以下命令:
Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e
或
Show me recent transactions for vitalik.eth
发展
要添加新功能或修改现有功能,请执行以下操作:
- 主服务器逻辑位于
src/server.ts - Etherscan API交互在
src/services/etherscanService.ts - 更改后构建:
npm run build
许可证
MIT许可证-有关详细信息,请参阅许可证文件