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 获取）

安装

通过 Smithery 安装

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

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 文件。