以太坊查询工具

以太坊MCP是一个为研究人员设计的工具,支持通过自然语言查询以太坊区块链数据,包括余额、交易、代币信息等。

  • by ETHCF
  • TypeScript
  • 本地部署
  • 36 星标
  • 更新于
在 GitHub 查看 ETHCF/ethereum-mcp

使用说明

以太坊MCP

用简单的英语查询以太坊。专为研究人员打造。


快速安装

使用克劳德代码?

将此粘贴到Claude代码中:

Install the Ethereum MCP from github.com/ETHCF/ethereum-mcp and configure it for me

克劳德会处理一切的。


使用OpenAI Codex?

将此粘贴到Codex中:

Install the Ethereum MCP from github.com/ETHCF/ethereum-mcp and configure it for me.  Edit ~/.codex/config.toml directly. Etherscan API key is "<key>".

Codex会处理一切。


使用终端?

运行以下命令:

curl -fsSL https://raw.githubusercontent.com/ETHCF/ethereum-mcp/main/install.sh | bash

按照提示操作。完成后重新启动Claude。


使用克劳德桌面?

  1. 克隆和构建:
git clone https://github.com/ETHCF/ethereum-mcp.git ~/.ethereum-mcp
cd ~/.ethereum-mcp && npm install && npm run build
  1. 打开配置文件:
open ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 添加此(替换 your-key-here 与你的 免费Etherscan API密钥):
{
  "mcpServers": {
    "ethereum": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/.ethereum-mcp/dist/index.js"],
      "env": {
        "ETHERSCAN_API_KEY": "your-key-here",
        "ETH_NODE_URL": "http://localhost:8545"
      }
    }
  }
}

ETH_NODE_URL 是可选的。如果设置,链上查询(余额、区块、交易、gas、日志)将使用您的节点作为主要来源,Etherscan作为回退。您还可以在运行时使用以下命令设置它 set_node_url.

  1. 重新启动克劳德桌面。

验证它是否有效

说: “与以太坊对话”

您应该看到一条包含可用数据源的欢迎消息。


你可以问什么

"Balance of vitalik.eth"
"What tokens does vitalik.eth hold?"
"Which L2 has the lowest fees?"
"What's the TVL of Uniswap vs Aave?"
"Internal transactions for 0xf8f74F2c34959F700F2617a71D19Be13BC42beb9"
"Top yield opportunities on Arbitrum"
"What's trending on CoinGecko?"
"Is gas cheap right now?"
"List supported chains" or "Switch to Base"

支撑链(60+)

使用相同的API密钥查询这些区块链中的任何一个:

主网: 以太坊、多边形、Base、Arbitrum、乐观主义、BNB、雪崩、Gnosis、Linea、Blast、Scroll、Mantle、Celo、Moonbeam、Moonriver、Fantom、Cronos、Fraxtal、opBNB、World、Sonic、Unichain、Abstract、Berachain、Sei、ApeChain、XDC、BitTorrent、Taiko、ArbitrumNova

测试网: Sepolia、Holesky、Base Sepolia,Arbitrum Sepolia和乐观Sepolia

使用 list_chains 查看全部或 set_chain 切换默认值。


数据源

来源 涵盖范围 API密钥
Etherscan 60多条链:余额、交易、代币、合约、日志、区块 免费(必填)
JSON-RPC 本地/自托管节点:余额、块、tx、gas、日志、存储 无(可选)
DefiLlama TVL、收益率、稳定币、DEX交易量、期权、费用、价格 无(Pro可选)
CoinGecko 代币价格、交易所、衍生品、NFT、类别 无(专业可选)
growthepie L2指标、费用、活动 无
Blobscan EIP-4844 blob数据 无
沙丘 自定义查询 免费(可选)

获取API密钥:


局限性

  • 查询限制:每次查询最多10000个结果
  • 价格滞后:数据可能落后1-5分钟
  • 历史:使用Dune查询超过10000的完整交易历史

工具(共153个)

Etherscan(43个工具)

账户和余额

工具 说明
get_eth_balance 任何地址或ENS名称的ETH余额
get_balance_multi 最多20个地址的批量余额
get_balance_history 特定区块的历史余额
get_address_tokens 按地址持有的所有ERC-20代币
get_address_nfts 按地址持有的所有NFT
get_token_balance 特定ERC-20代币余额
get_mined_blocks 按地址挖掘的块
get_transaction_count 地址的交易计数(nonce)

交易和转账

工具 说明
get_transactions 最近的外部交易(最多1万笔)
get_internal_transactions 内部交易(合约调用)总计
get_token_transfers ERC-20代币转移历史
get_nft_transfers ERC-721 NFT传输历史
get_erc1155_transfers ERC-1155多代币转账
get_beacon_withdrawals 从验证者处质押提款

区块链

工具 说明
get_block_number 最新区块编号
get_block 按编号列出的详细区块信息
get_block_reward 阻止奖励和叔叔信息
get_block_countdown 距离未来区块还有一段时间
get_block_by_timestamp 按时间戳查找块

交易与收款

工具 说明
get_transaction 按哈希计算的交易详细信息
get_tx_receipt 带有日志的交易收据
get_tx_status 检查tx是否成功/失败

合同

工具 说明
get_contract_abi ABI用于验证合同
get_contract_source 已验证的源代码和元数据
get_contract_creator 合约部署器和tx哈希
get_code 合约字节码
eth_call 只读合同调用
get_storage 存储槽值
estimate_gas 天然气估算

日志和事件

工具 说明
get_logs 带有主题过滤的事件日志

统计与网络

工具 说明
get_gas_price 当前天然气价格
get_gas_estimate 天然气价格确认时间
get_eth_price ETH价格(美元/BTC)
get_eth_supply ETH总供应量
get_node_count 以太坊节点计数
get_daily_stats 每日链统计数据(区块、天然气、费用、地址等)

代币

工具 说明
get_token_supply ERC-20总供应量
get_token_info 令牌元数据(名称、符号、小数)
get_token_holders 带有余额的代币持有者列表

多链

工具 说明
list_chains 列出所有60+支持的链
set_chain 切换默认区块链

JSON-RPC节点(1个工具)

连接本地或自托管的以太坊节点。配置后,链上查询使用节点作为主源,Etherscan作为回退。节点的链会被自动检测,跨链查询会路由到正确的源。

工具 说明
set_node_url 连接到JSON-RPC节点(验证连接,检测链)

DefiLama(42工具)

API密钥设置

工具 说明
set_defillama_key 设置DefiLlama Pro API密钥(可选)

TVL和协议 (免费)

工具 说明
get_chain_tvl TVL适用于所有链条
get_historical_tvl 历史TVL数据
get_protocol_tvl 特定协议的TVL
get_protocol_info 详细的协议分解
search_protocols 按名称/类别搜索

产量 (免费+专业版)

工具 说明
get_top_yields APY的主要机会
get_yield_pool_chart 池的历史APY图表(专业版)
get_borrow_rates 跨协议借款利率(Pro)
get_lend_borrow_chart 借贷利率图表(Pro)
get_perps_rates 永久融资率(Pro)
get_lsd_rates 流动性质押率(Pro)

稳定币 (免费)

工具 说明
get_stablecoins 稳定币市值
get_stablecoin_dominance 稳定币在每条链中的主导地位
get_stablecoin_detail 详细的稳定币数据
get_stablecoin_chains 带有稳定币数据的链

DEX交易量 (免费)

工具 说明
get_dex_volumes 24小时DEX交易量
get_dex_volumes_by_chain 每条链的DEX量
get_dex_protocol 特定DEX数据

衍生品 (专业)

工具 说明
get_derivatives_volumes 衍生品交易量
get_derivatives_protocol 特定衍生协议数据

选项 (免费)

工具 说明
get_options_volumes 期权交易量
get_options_protocol 特定选项协议

费用和收入 (免费)

工具 说明
get_fees 协议费用概述
get_protocol_fees 具体协议费

价格 (免费)

工具 说明
get_coin_prices 按地址列出的代币价格
get_coin_prices_historical 历史代币价格
get_coin_chart 价格图表数据
get_coin_percent_change 价格变动百分比
get_coin_first_price 首次记录价格
get_block_by_timestamp 时间戳处的区块编号

排放与解锁 (专业)

工具 说明
get_emissions 代币发行/解锁概述
get_emission 具体协议排放时间表

生态系统 (专业)

工具 说明
get_categories 按TVL分类的DeFi
get_forks 协议分叉数据
get_oracles DeFi中的Oracle使用情况
get_treasuries 协议金库持有量
get_hacks 历史上的DeFi黑客
get_raises 加密货币融资轮次

桥梁 (专业)

工具 说明
get_bridges 所有交叉链桥
get_bridge 具体桥梁详图
get_bridge_volume 按链计算的桥梁体积

growthepie (9 工具)

L2概述

工具 说明
get_l2_overview 所有L2 TVL+活动
get_l2_fees 比较L2交易费用
get_l2_chain 特定L2的详细指标(所有11个指标)
get_blob_data L2支付的EIP-4844 blob费用

排名与比较

工具 说明
get_l2_metric_ranking 按任何指标(tvl、daa、利润等)对L2进行排名
get_l2_all_metrics 所有L2的综合指标
get_l2_profitability L2盈利能力比较
get_l2_activity 按每日活跃地址划分的L2活动
get_l2_chains_list 列出所有跟踪的L2链及其元数据

CoinGecko(30工具)

API密钥设置

工具 说明
set_coingecko_key 设置CoinGecko Pro API密钥(可选)

价格和搜索 (免费)

工具 说明
get_token_price 按名称/符号列出的任何代币的价格
get_token_price_by_contract 按合约地址列出的代币价格
get_top_tokens 市值最高的加密货币
get_trending_tokens CoinGecko的趋势
search_tokens 按名称搜索令牌

硬币数据 (免费)

工具 说明
get_coin_details 详细的硬币信息
get_coin_history 特定日期的历史数据
get_coin_chart 价格图表数据
get_coin_ohlc OHLC烛台数据
get_coin_tickers 交易硬币的交易所
get_coin_by_contract 按合同地址列出的硬币数据

全球&类别 (免费)

工具 说明
get_global_market 全球加密货币市场统计数据
get_global_defi 全球DeFi市场统计
get_categories 包含市场数据的加密货币类别
get_asset_platforms 区块链平台列表
get_exchange_rates BTC汇率

交易所 (免费)

工具 说明
get_exchanges 按交易量排名的顶级交易所
get_exchange 具体兑换明细
get_exchange_tickers 交易所交易对
get_exchange_volume_chart 交换量历史记录

衍生品 (免费)

工具 说明
get_cg_derivatives 衍生品行情
get_derivatives_exchanges 衍生品交易所

NFT (免费+专业版)

工具 说明
get_nfts_list NFT收藏列表
get_nft_details NFT收集详细信息
get_nft_markets 按市值划分的NFT市场(Pro)
get_nft_chart NFT价格历史(专业版)

专业版功能

工具 说明
get_top_movers 最大赢家和输家(Pro)
get_new_coins 最近添加的硬币(Pro)
get_global_chart 历史全球市值(Pro)

Blobscan(13工具)

斑点

工具 说明
get_recent_blobs 最近的EIP-4844斑点
get_blob 按版本化哈希列出的特定blob的详细信息
get_blobs_by_address 由特定地址发布的金发女郎

交易

工具 说明
get_blob_transactions 最近的blob携带交易
get_blob_transaction 按哈希计算的交易详细信息

积木

工具 说明
get_blob_block 带有blob详细信息的块
get_latest_blob_block 包含blob的最新块

统计

工具 说明
get_blob_stats 聚合blob统计信息
get_blob_counts Blob、块、事务总数
get_blob_daily_stats 每日blob统计
get_blob_block_stats 块级blob统计信息
get_blob_tx_stats 事务级blob统计

搜索

工具 说明
blobscan_search 搜索blob、block、tx、地址

沙丘(10工具)

API密钥和查询执行

工具 说明
set_dune_key 设置Dune API密钥
run_dune_query 按ID执行查询
get_dune_results 获取缓存的查询结果
get_dune_results_csv 以CSV格式获取缓存结果
get_dune_query_info 获取查询元数据(名称、描述、参数)
get_dune_execution_status 检查执行状态
cancel_dune_execution 取消正在运行的执行

预设端点(无需自定义查询)

工具 说明
get_eigenlayer_avs 特征层AVS元数据和度量
get_eigenlayer_operators 特征层算子元数据和度量
get_dune_token_balances 实时代币余额(开发者API)

智能路由(5个工具)

具有数据源之间自动回退功能的工具,可提高可靠性。

工具 说明
smart_get_price 代币价格有回落(CoinGecko->DefiLama)
smart_get_eth_price ETH价格有回落(Etherscan->CoinGecko->DefiLama)
smart_get_l2_tvl L2带回退的TVL(生长阶段->挑战阶段)
api_health_check 检查所有数据源的运行状况和延迟
compare_eth_price_sources 比较所有来源的ETH价格

贡献

PR欢迎!要添加新数据源,请执行以下操作:

  1. 在中创建适配器 src/adapters/
  2. 添加工具 src/index.ts

学分

建造于 帕特·麦高恩 在 号码组 为了 以太坊社区基金会.

MIT许可证