用途
evmscope 是一个 EVM 区块链情报工具包,专为 AI 智能体设计。像 Claude 和 GPT 这样的 AI 无法访问实时区块链数据——当你问“ETH 价格是多少?”或“显示这个钱包的余额”,通常会得到“我无法访问实时数据”的回复。evmscope 通过 MCP 协议让 AI 智能体直接访问 26 个链上工具,包括代币价格、钱包余额、DeFi 收益率、鲸鱼追踪、蜜罐检测等。无需 API 密钥、无需配置,连接即可使用。
主要能力
工具覆盖以下方面:
- 价格与市场:获取代币当前价格、24 小时涨跌、市值和成交量。
- Gas 费用:获取 slow/normal/fast 三档 Gas 价格及美元估算,并可跨全部 7 条 EVM 链对比 Gas 费用,按成本从低到高排序。
- 账户与余额:获取原生代币 + ERC-20 代币余额及美元价值;获取完整钱包投资组合(含原生代币与 ERC-20 余额及美元价值);获取 ERC-20 代币元数据(名称、符号、精度、总供应量)。
- ENS:将 ENS 名称解析为地址及反向解析(仅限 Ethereum 主网)。
- 交易相关:获取交易状态、收据、确认数和 Gas 使用量;将交易解码为结构化 JSON(函数名、参数、事件日志);通过 eth_call + estimateGas 模拟交易,返回美元 Gas 估算及失败时的回滚原因;获取某钱包最近 ERC-20 代币转账历史。
- 合约与事件:查询已验证合约的 ABI(Etherscan → Sourcify 回退);获取合约事件日志并自动进行 ABI 解码。
- 地址识别:识别地址是交易所、DeFi 协议、鲸鱼钱包还是 EOA。
- 授权与持仓:检查 ERC-20 代币授权(allowance)状态,自动检查主要 DeFi 协议并给出风险等级评估;获取代币前几大持有者(Ethereum 使用 Ethplorer,其他链从 Etherscan 转账记录聚合)。
- TVL 与收益率:通过 DefiLlama 获取 DeFi 协议 TVL(含链上细分、24 小时/7 天变化);获取 DeFi 收益率(APY),可按协议、链、最低 TVL 过滤。
- 鲸鱼追踪:追踪大额代币转账(鲸鱼动向),分类交易所存入/提取方向。
- 兑换与跨链:通过 ParaSwap 获取 DEX 兑换报价(最优路由、Gas 成本、自动 ETH→WETH 转换);通过 LI.FI 获取跨链桥路由,比较费用、时间和输出金额。
- 安全检测:通过 Honeypot.is 检测蜜罐(诈骗)代币,返回买入/卖出税、风险等级和标记。
- NFT:获取钱包的 ERC-721 NFT 余额和代币列表;获取特定 NFT 代币的元数据(名称、图片、属性)。
- 治理与区块:从 Snapshot 获取治理提案(活跃、已关闭或全部);按区块号或最新获取区块详情(时间戳、Gas、交易、验证者)。
使用方式
CLI 模式
运行 npx evmscope --help 查看全部 22 个命令。添加 --json 可输出原始 JSON。
MCP 服务器模式
不带参数运行即启动 MCP 服务器。
添加到 claude_desktop_config.json:
(配置方式见项目文档)
添加到 .cursor/mcp.json:
(配置方式见项目文档)
支持的链
Ethereum、Polygon、Arbitrum、Base、Optimism、Avalanche、BSC。
环境变量(可选)
所有环境变量均为可选。evmscope 无需任何配置即可运行。
关键特性
- 26 个工具:Price、gas compare、swap quote、yield rates、honeypot detection、bridge routes、tx simulation、event logs、token holders、approval status、TVL、whale tracking、balance、token info、ENS、tx status、tx decode、ABI lookup、address ID、NFT info、NFT metadata、governance proposals、block info、token transfers、portfolio。
- 7 条 EVM 链:Ethereum、Polygon、Arbitrum、Base、Optimism、Avalanche、BSC。
- 49 种内置代币:ETH、USDC、USDT、WETH、LINK、UNI、AAVE、ARB、OP、PEPE 等。
- 30+ 已标注地址:交易所、DeFi 协议、跨链桥、鲸鱼钱包。
- 零配置:无需 API 密钥,基于免费公共 API 开箱即用。
- 只读:不执行交易,零资金损失风险。
- 双模式:CLI 用于终端直接使用,MCP 服务器用于 AI 智能体集成。
版本历史
- v0.1(已完成)—— 5 个工具:price、transaction fees、balance、token info、ENS
- v0.5(已完成)—— +4 个工具:decodeTx、getTxStatus、getContractABI、identifyAddress
- v1.0(已完成)—— +5 个工具:compareGas、getApprovalStatus、getProtocolTVL、getWhaleMovements、getSwapQuote
- v1.5(已完成)—— +6 个工具:simulateTx、getYieldRates、getTokenHolders、getContractEvents、checkHoneypot、getBridgeRoutes
- v1.5.1(已完成)—— 代码质量与安全重构:7 个新共享模块、按链配置 RPC URL、缓存大小限制、统一地址校验、CLI 模块化
- v1.6.0(已完成)—— +3 个工具:getNFTInfo、getNFTMetadata、getGovernanceProposals。+2 条链:Avalanche、BSC
- v1.7.0(已完成)—— +3 个工具:getBlockInfo、getTokenTransfers、getPortfolio。安全加固(v1.6.1)
限制
- 只读模式,不执行任何交易。
- 部分工具的数据源或链范围有限(如 ENS 仅限 Ethereum 主网;代币持有者查询在 Ethereum 使用 Ethplorer,其他链聚合自 Etherscan 转账)。
- 具体定价、收费或额外使用条款暂未提供。