SuperAPI AI 工具集

evmscope

evmscope 是一个面向 AI 智能体的 EVM 区块链情报工具包,让 Claude、GPT 等无法直接访问实时链上数据的 AI 能够通过 MCP 协议查询区块链信息。它提供 26 个工具、覆盖 7 条 EVM 链(Ethereum、Polygon、Arbitrum、Base、Optimism、Avalanche、BSC),支持代币价格、Gas 费用对比、兑换报价、收益率、蜜罐检测、跨链桥路由、交易模拟、NFT 查询、治理提案、投资组合追踪等功能。工具零配置,无需 API 密钥,开箱即用(基于免费公共 API),且为只读模式,不执行交易、无资金损失风险。可同时作为 CLI 命令行工具或 MCP 服务器使用——不带参数运行即启动 MCP 服务器,运行 npx evmscope --help 查看全部 22 个命令,加 --json 可输出原始 JSON。内置 49 种代币和 30+ 已标注地址(交易所、DeFi 协议、跨链桥、鲸鱼钱包),并支持通过环境变量(全部可选)进行定制。

访问官网

工具介绍

用途

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 转账)。
  • 具体定价、收费或额外使用条款暂未提供。