Dune Analytics MCP Server

一个将 Dune Analytics 数据连接到 AI 代理的 MCP 服务器。

特性

• 工具：
  • get_latest_result: 根据ID获取 Dune 查询的最新结果。
  • run_query: 执行指定ID的 Dune 查询并获取结果。
• CSV 输出：所有结果均以 CSV 格式的字符串返回，便于处理。

预备条件

• Python 3.10+
• 有效的 Dune Analytics API 密钥（从 Dune Analytics 获取）

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Dune Analytics for Claude Desktop：

npx -y @smithery/cli install @kukapay/dune-analytics-mcp --client claude

手动安装

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 一起使用。

工具使用

1. get_latest_result(query_id)

   • 描述：检索指定 Dune 查询的最新结果。
   • 输入：query_id (int) - Dune 查询的ID。
   • 输出：查询结果的 CSV 格式字符串。
   • 示例：

     get_latest_result(query_id=4853921)
     

2. run_query(query_id)

   • 描述：执行 Dune 查询并返回结果。
   • 输入：query_id (int) - 要运行的 Dune 查询的ID。
   • 输出：查询结果的 CSV 格式字符串。
   • 示例：

     run_query(query_id=1215383)
     

在 Claude Desktop 中的示例命令

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

许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。