Skip to content

clumsynonono/ethereum-dune-mcp

BranchesTags

Repository files navigation

Ethereum Dune MCP Server

中文 | English

中文

专为 RIG (Research Incentive Group) 研究设计的以太坊数据分析 MCP 服务器。

特点

  • 49 个工具: 覆盖 Blob、DEX、Staking、MEV、BuilderNet、L2 MEV 等核心指标
  • 免费查询: 所有预设工具只读取缓存，不消耗 API 额度
  • RIG 研究导向: 支持经济安全性、去中心化、MEV 风险分析

快速开始

npm install && cp .env.example .env && npm run build

工具列表 (49个)

Blob 分析 (7个) - hildobby/blobs

工具 Query ID 用途
blob_total_fees 4104427 DA 费用/拥堵
blob_data_inflow 4077661 L2 活跃度
blob_storage_size 4077761 累计存储
blob_chain_ratio 4780618 各链占比
blob_base_fee 3591214 4844 价格信号
blob_recent_24h 5072258 24h 监控
blob_fullness 5124588 填充效率

DEX 分析 (7个) - hagaetc/dex-metrics

工具 Query ID RIG 意义
dex_volume_24h 4234 MEV 机会
dex_volume_7d 4235 收入趋势
dex_eth_share 21693 主网份额
dex_weekly_by_chain 2180075 L2 迁移
dex_ranked 4319 DEX MEV 贡献
dex_frontend_share 3364122 用户行为
dex_bot_usage 2687239 Bot/MEV 风险

Staking 分析 (10个) - hildobby/eth2-staking

工具 Query ID RIG 意义
staking_eth_staked 1933035 经济安全性
staking_validators 1933036 去中心化
staking_by_entity 3383110 HHI 集中度
staking_unstaked 2393992 赎回风险
staking_full_withdrawals 2394053 系统性撤退
staking_delta_week 1945604 短期变动
staking_delta_month 1945549 中期变动
staking_delta_6m 1945623 长期变动
staking_liquid 1941374 LST 份额
staking_restaking 3548849 Restaking 风险

Ethereum 指标 (7个)

工具 Query ID 用途
eth_block_builders 5090511 PBS/MEV 集中度
eth_gas_fees 3195150 拥堵分析
eth_median_gas 651463 Gas 基准
eth_burned 3186349 EIP-1559
eth_active_addresses 651474 需求侧
eth_tx_count 651398 Blockspace 需求
eth_price 663019 价格

MEV Blocker (6个)

工具 Query ID RIG 意义
mev_total_rebates 2456432 OFV 总量
mev_rebates_by_builder 2771596 Builder 行为
mev_rebates_by_searcher 2771602 Searcher 竞争
mev_wait_times 2441895 OFA 效率
mev_volume_protected 2635139 保护量
mev_success_rate 2441649 成功率

BuilderNet (4个)

工具 Query ID RIG 意义
buildernet_stats 4341814 Revenue/Bundles/Blocks
buildernet_gas_refunds 4378423 补贴机制风险
buildernet_monthly_refunds 4378475 月度趋势
buildernet_operators 4258012 Builder 集中度

L2 MEV (8个)

工具 Query ID RIG 意义
l2_atomic_arb_by_chain 3416651 L2 MEV 规模 (1Y)
l2_atomic_arb_trades 3416499 MEV 活跃度
l2_atomic_arb_cumulative 3416882 MEV 增长曲线
l2_atomic_arb_1m 3635408 近期热度
l2_sandwich_cumulative 3601907 用户损失
l2_sandwich_trades 3601836 各链保护差异
l2_base_mev_extracted 3688247 Sequencer 收入
l2_base_mev_daily 4628919 每日利润

工具函数 (3个)

工具 描述
custom_query [免费] 任意查询缓存
execute_query [消耗额度] 执行查询
list_queries 列出所有 ID

RIG 研究场景

经济安全性

staking_eth_staked × eth_price = Security Budget
staking_by_entity → HHI = Σ(marketshare²)

MEV 风险

dex_volume_24h spike → MEV 机会上升
dex_bot_usage spike → meme coin craze
eth_block_builders → Builder 集中度

L2 迁移

dex_eth_share 下降 → L2 夺取执行需求
blob_data_inflow → 各 L2 真实 DA 需求

赎回风险

staking_unstaked / staking_eth_staked > 0.5% → 高风险
staking_full_withdrawals → 系统性撤退信号

L2 MEV 分析

l2_atomic_arb_by_chain → 各 L2 MEV 规模对比
l2_sandwich_cumulative → 用户被夹损失
l2_base_mev_extracted → Base Sequencer 收入

MCP 配置

{
  "mcpServers": {
    "ethereum-dune": {
      "command": "node",
      "args": ["/path/to/ethereum-dune-mcp/dist/index.js"]
    }
  }
}

English

Ethereum data analytics MCP server designed for RIG (Research Incentive Group) research.

Features

  • 49 tools: Covering Blob, DEX, Staking, MEV, BuilderNet, L2 MEV and other core metrics
  • Free queries: All preset tools only read cached results, no API credits consumed
  • RIG research-oriented: Support for economic security, decentralization, and MEV risk analysis

Quick Start

npm install && cp .env.example .env && npm run build

Tool List (49 tools)

Blob Analytics (7) - hildobby/blobs

Tool Query ID Purpose
blob_total_fees 4104427 DA cost/congestion
blob_data_inflow 4077661 L2 activity
blob_storage_size 4077761 Cumulative storage
blob_chain_ratio 4780618 Chain distribution
blob_base_fee 3591214 EIP-4844 price signal
blob_recent_24h 5072258 24h monitoring
blob_fullness 5124588 Fill efficiency

DEX Analytics (7) - hagaetc/dex-metrics

Tool Query ID RIG Significance
dex_volume_24h 4234 MEV opportunities
dex_volume_7d 4235 Revenue trends
dex_eth_share 21693 Mainnet share
dex_weekly_by_chain 2180075 L2 migration
dex_ranked 4319 DEX MEV contribution
dex_frontend_share 3364122 User behavior
dex_bot_usage 2687239 Bot/MEV risk

Staking Analytics (10) - hildobby/eth2-staking

Tool Query ID RIG Significance
staking_eth_staked 1933035 Economic security
staking_validators 1933036 Decentralization
staking_by_entity 3383110 HHI concentration
staking_unstaked 2393992 Redemption risk
staking_full_withdrawals 2394053 Systemic withdrawal
staking_delta_week 1945604 Short-term change
staking_delta_month 1945549 Medium-term change
staking_delta_6m 1945623 Long-term change
staking_liquid 1941374 LST share
staking_restaking 3548849 Restaking risk

Ethereum Metrics (7)

Tool Query ID Purpose
eth_block_builders 5090511 PBS/MEV concentration
eth_gas_fees 3195150 Congestion analysis
eth_median_gas 651463 Gas baseline
eth_burned 3186349 EIP-1559 burn
eth_active_addresses 651474 Demand side
eth_tx_count 651398 Blockspace demand
eth_price 663019 Price

MEV Blocker (6)

Tool Query ID RIG Significance
mev_total_rebates 2456432 OFV total
mev_rebates_by_builder 2771596 Builder behavior
mev_rebates_by_searcher 2771602 Searcher competition
mev_wait_times 2441895 OFA efficiency
mev_volume_protected 2635139 Protected volume
mev_success_rate 2441649 Success rate

BuilderNet (4)

Tool Query ID RIG Significance
buildernet_stats 4341814 Revenue/Bundles/Blocks
buildernet_gas_refunds 4378423 Subsidy mechanism risk
buildernet_monthly_refunds 4378475 Monthly trends
buildernet_operators 4258012 Builder concentration

L2 MEV (8)

Tool Query ID RIG Significance
l2_atomic_arb_by_chain 3416651 L2 MEV scale (1Y)
l2_atomic_arb_trades 3416499 MEV activity
l2_atomic_arb_cumulative 3416882 MEV growth curve
l2_atomic_arb_1m 3635408 Recent activity
l2_sandwich_cumulative 3601907 User losses
l2_sandwich_trades 3601836 Chain protection diff
l2_base_mev_extracted 3688247 Sequencer revenue
l2_base_mev_daily 4628919 Daily profit

Utility Functions (3)

Tool Description
custom_query [Free] Get any query cache
execute_query [Costs credits] Execute query
list_queries List all query IDs

RIG Research Scenarios

Economic Security

staking_eth_staked × eth_price = Security Budget
staking_by_entity → HHI = Σ(marketshare²)

MEV Risk

dex_volume_24h spike → MEV opportunities increase
dex_bot_usage spike → meme coin craze
eth_block_builders → Builder concentration

L2 Migration

dex_eth_share decline → L2 captures execution demand
blob_data_inflow → Real L2 DA demand

Redemption Risk

staking_unstaked / staking_eth_staked > 0.5% → High risk
staking_full_withdrawals → Systemic withdrawal signal

L2 MEV Analysis

l2_atomic_arb_by_chain → L2 MEV scale comparison
l2_sandwich_cumulative → User sandwich losses
l2_base_mev_extracted → Base Sequencer revenue

MCP Configuration

{
  "mcpServers": {
    "ethereum-dune": {
      "command": "node",
      "args": ["/path/to/ethereum-dune-mcp/dist/index.js"]
    }
  }
}

License

MIT

About

MCP server for Ethereum research: EIP-1559, Blobs, and MEV analytics powered by Dune

Resources

Readme
Activity

Stars

23 stars

Watchers

0 watching

Forks

7 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages