Dune Analytics MCP 服务器

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

功能

• 工具：
  • get_latest_result：通过 ID 获取 Dune 查询的最新结果。
  • run_query：通过 ID 执行 Dune 查询并获取结果。
• 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 桌面版：

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

  将服务器安装为服务，以便与 Claude 桌面版一起使用。

工具使用

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 桌面版中的示例命令

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

许可证

该项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。