AI导哈

区块链数据分析服务

Dune Analytics MCP Server 是一个提供与 Dune Analytics 无缝集成的模型上下文协议服务器，支持执行查询、管理表格、处理物化视图以及直接访问区块链分析数据。

  • by hajnalben
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 hajnalben/dune-analytics-mcp

使用说明

沙丘分析MCP服务器

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

特性

  • 查询执行：使用参数执行Dune查询，以JSON或CSV格式获取结果
  • 查询管理：以编程方式创建、更新、存档和管理Dune查询
  • 自定义表格：在Dune命名空间中创建和管理自定义数据表
  • 物化视图：使用自动刷新计划设置和管理物化视图
  • 自定义端点：访问自定义API端点以进行专门的数据检索
  • API全面覆盖：对Dune Analytics API的全面支持

先决条件

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

从获取API密钥 dune.com/settings/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 API密钥 dune.com/settings/api.

与Claude Desktop一起使用

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

{
  "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 dune-analytics-mcp

可用工具

查询执行

  • 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 -创建新的沙丘查询
  • 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服务器提供沙丘分析API的完整覆盖范围：

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

发展

# Clone the repository
git clone https://github.com/hajnalben/dune-analytics-mcp.git
cd dune-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
DUNE_API_KEY=your_key node dist/index.js

需求

  • Node.js>=20.0.0（LTS）
  • 沙丘分析API密钥

链接

许可证

MIT许可证-请参阅 许可证 详细信息文件

贡献

欢迎投稿！请随时提交拉取请求。

支持

对于问题和疑问：

相关 MCP