Dune Analytics MCP 服务器

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

功能

• 工具：
  • 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上使用。

工具使用方法

1. get_latest_result(query_id)

   • 描述：获取指定Dune查询的最新结果。
   • 输入：query_id（整数）- Dune查询的ID。
   • 输出：CSV格式字符串，包含查询结果。
   • 示例：

     get_latest_result(query_id=4853921)
     

2. run_query(query_id)

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

     run_query(query_id=1215383)
     

Claude Desktop 示例命令

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

许可证

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