dune-analytics-mcp

🚀 Dune Analytics MCP 服务器

Dune Analytics MCP 服务器是一个强大的工具，它可以将 Dune Analytics 中的数据桥接到 AI 代理，为数据的获取和处理提供了便捷的途径。

🚀 快速开始

本服务器能将 Dune Analytics 数据无缝桥接到 AI 代理，为数据获取与应用带来便利。使用前，你需要确保满足先决条件，并完成安装步骤。

✨ 主要特性

• 丰富工具支持：
  • get_latest_result：可轻松获取指定 Dune 查询 ID 的最新结果。
  • run_query：能执行指定 Dune 查询 ID 并获取相应结果。
• 便捷的 CSV 输出：所有结果均以 CSV 格式字符串返回，极大地方便了后续的数据处理工作。

📦 安装指南

先决条件

• 需要安装 Python 3.10 及以上版本。
• 你要拥有一个有效的 Dune Analytics API 密钥，可从Dune Analytics获取。

安装步骤

1. 克隆仓库：

   git clone https://github.com/kukapay/dune-analytics-mcp.git
   cd dune-analytics-mcp
   

2. 设置环境变量： 你可以在项目根目录创建一个.env文件：

   DUNE_API_KEY=your_api_key_here
   

   或者将其设置为系统环境变量：

   export DUNE_API_KEY="your_api_key_here"
   

💻 使用示例

运行服务器

• 开发模式：

  mcp dev main.py
  

  此命令会以带热重载的方式启动服务器，方便开发调试。

• 安装到 Claude Desktop：

  mcp install main.py --name "Dune Analytics"
  

  通过该命令可将其安装为服务，以便在 Claude Desktop 上使用。

工具使用方法

基础用法

# 使用 get_latest_result 获取指定 Dune 查询的最新结果
get_latest_result(query_id=4853921)

# 使用 run_query 执行指定 Dune 查询并返回结果
run_query(query_id=1215383)

高级用法

在实际使用中，你可以将这些工具与其他数据处理流程相结合，实现更复杂的功能。例如，可以将获取到的 CSV 数据进行解析和分析，以满足特定的业务需求。

Claude Desktop 示例命令

• “获取 Dune 查询 1215383 的最新结果”
• “运行 Dune 查询 1215383”

📄 许可证

该项目使用 MIT 许可证，有关详细信息，请参阅LICENSE文件。