用途:通过 uxc 以统一命令行方式调用 Etherscan MCP,完成链上数据查询与合约研究。
主要能力:地址调查(balance、tokenHoldings、fundedBy、getAddressMetadata);代币持有分析(balanceERC20、balanceERC20Historical、tokenTopHolders、getTokenInfo);交易调查(txList、internalTxsByAddress、erc20Transfers、erc721Transfers、erc1155Transfers、transaction、checkTransaction);合约研究(getContractAbi、getContractSourceCode、getContractCreation);验证(verifySourceCode、checkVerifyStatus)。
使用方式:先确认端点与协议:uxc https://mcp.etherscan.io/mcp -h,未认证时预期返回 401 Unauthorized。配置认证:uxc auth credential set etherscan-mcp --auth-type bearer --secret-env ETHERSCAN_API_KEY,然后 uxc auth binding add --id etherscan-mcp --host mcp.etherscan.io --path-prefix /mcp --scheme https --credential etherscan-mcp --priority 100。默认使用固定链接命令:command -v etherscan-mcp-cli,缺失时执行 uxc link etherscan-mcp-cli https://mcp.etherscan.io/mcp。执行前先用 <operation> -h 检查参数,例如 etherscan-mcp-cli balance -h。etherscan-mcp-cli <operation> ... 等价于 uxc https://mcp.etherscan.io/mcp <operation> ...。
适用场景:按单一链/地址/代币逐步开展只读调查,从余额、持仓集中度、交易详情或合约源码元数据入手,解析 JSON 信封后读取数据。优先使用 JSON 输出,解析 ok、kind、protocol、data、error 等稳定字段;简单标量用 key=value,嵌套对象或数组建议用位置 JSON。
限制:部分 MCP 工具受 Etherscan 套餐分级限制,例如非 Pro key 的 getTokenInfo 可能返回 NOTOK 并提示升级 API Pro。verifySourceCode 属写类操作,需用户明确确认。不要凭记忆猜测参数名,Etherscan 可能独立调整 MCP schema,调用前应查看 -h。401 时检查绑定与凭据信息并按需重置为 bearer。