Dune Analytics MCP Server

一个提供与Dune Analytics无缝集成的模型上下文协议（MCP）服务器。通过MCP协议执行查询、管理表、操作物化视图，并直接访问区块链分析数据。

功能

• 查询执行：带有参数的Dune查询执行，获取JSON或CSV格式的结果
• 查询管理：程序化地创建、更新、归档和管理Dune查询
• 自定义表：在您的Dune命名空间中创建和管理自定义数据表
• 物化视图：设置并管理具有自动刷新计划的物化视图
• 自定义端点：访问用于专门数据检索的自定义API端点
• 全面API支持：对Dune Analytics API的全面支持

预备条件

您需要一个Dune Analytics API密钥才能使用此MCP服务器。

从dune.com/settings/api获取您的API密钥。您需要：

1. 注册或登录到Dune Analytics
2. 导航至设置 → API
3. 创建一个新的API密钥
4. 复制该密钥以供下面的安装步骤使用

安装

使用Claude Code快速开始

claude mcp add --transport stdio dune-analytics-tools --env DUNE_API_KEY=your_api_key_here -- npx -y dune-analytics-mcp

将your_api_key_here替换为您从dune.com/settings/api获取的实际Dune API密钥。

使用Claude Desktop

添加到您的Claude Desktop配置（macOS上的~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "dune": {
      "command": "npx",
      "args": ["-y", "dune-analytics-mcp"],
      "env": {
        "DUNE_API_KEY": "your_api_key_here"
      }
    }
  }
}

包安装

npm install dune-analytics-mcp

或者全局安装：

npm install -g d

可用工具

查询执行

• execute_query - 开始查询执行（返回execution_id）
• get_execution_status - 检查正在运行的查询状态
• get_execution_results - 获取已完成查询的结果（JSON）
• get_execution_results_csv - 获取CSV格式的结果
• cancel_execution - 取消正在运行的查询
• run_query - 执行查询并等待结果（方便方法）
• get_latest_results - 获取缓存的结果而不使用积分
• get_latest_results_csv - 获取CSV格式的缓存结果

查询管理

• create_query - 创建新的Dune查询
• update_query - 更新现有查询
• read_query - 读取查询元数据和SQL
• archive_query - 归档查询
• unarchive_query - 恢复已归档的查询
• make_query_private - 将查询设为私有
• make_query_public - 将查询设为公开

表管理

• create_table - 创建自定义数据表
• insert_table - 向表中插入数据（CSV/JSON/NDJSON）
• delete_table - 删除表

物化视图

• list_materialized_views - 列出所有物化视图
• upsert_materialized_view - 创建或更新物化视图
• delete_materialized_view - 删除物化视图
• refresh_materialized_view - 手动触发刷新

自定义端点

• get_custom_results - 通过用户名/别名访问自定义API端点

API覆盖

此MCP服务器提供了对Dune Analytics API的全面覆盖：

• ✅ 查询执行API
• ✅ 查询管理API
• ✅ 表管理API
• ✅ 物化视图API
• ✅ 自定义端点API

开发

# 克隆仓库
git clone https://github.com/hajnalben/dune-analytics-mcp.git
cd dune-mcp

# 安装依赖
npm install

# 构建
npm run build

# 本地运行
DUNE_API_KEY=your_key node dist/index.js

要求

• Node.js >= 20.0.0 (LTS)
• Dune Analytics API密钥

链接

• Dune Analytics
• Dune API 文档
• 模型上下文协议

许可证

MIT 许可证 - 详情见LICENSE文件

贡献

欢迎贡献！请随时提交Pull Request。

支持

对于问题和疑问：

• GitHub Issues