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

• "Get latest results for dune query 1215383" (获取 dune 查询 1215383 的最新结果)
• "Run dune query 1215383" (运行 dune 查询 1215383)

许可证

该项目根据 MIT 许可证授权 - 有关详细信息，请参见 LICENSE 文件。