Dune Analytics MCP

🚀 Dune Analytics MCP 服务器

Dune Analytics MCP 服务器是一款强大的工具，它能够将 Dune Analytics 中的数据无缝桥接到 AI 代理，为数据处理和分析带来极大便利。

✨ 主要特性

• 实用工具：
  • get_latest_result：可轻松获取指定 Dune 查询 ID 的最新结果。
  • run_query：执行指定 Dune 查询 ID 并获取相应结果。
• 便捷输出：所有结果均以 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(query_id)
  • 描述：获取指定 Dune 查询的最新结果。
  • 输入：query_id（整数）- Dune 查询的 ID。
  • 输出：CSV 格式字符串，包含查询结果。
  • 示例：

    get_latest_result(query_id=4853921)
    

高级用法

• run_query(query_id)
  • 描述：执行指定 Dune 查询并返回结果。
  • 输入：query_id（整数）- 要运行的 Dune 查询 ID。
  • 输出：CSV 格式字符串，包含查询结果。
  • 示例：

    run_query(query_id=1215383)
    

Claude Desktop 示例命令

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

📄 许可证

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