Dune Analytics MCP Server

Name: Dune Analytics MCP Server
Author: kukapay

本地服务

github.com/kukapay数据与分析4178 周前更新

代码仓库

关于 Dune Analytics MCP Server

Dune Analytics MCP Server 是一个将 Dune Analytics 查询结果提供给 AI Agent 的 MCP 服务。它以 CSV 格式返回结果，适合需要读取链上或分析数据的用户。

主要功能

01获取查询的最新结果
02按 ID 执行 Dune 查询并返回结果
03结果统一以 CSV 字符串返回
04通过 DUNE_API_KEY 进行身份验证

适用场景

01让 AI Agent 读取已有 Dune 查询的最新数据
02在 Claude Desktop 中直接运行指定查询

MCP 相关

该服务向 MCP 客户端暴露 get_latest_result 与 run_query 两个工具，供客户端调用 Dune 查询。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dune-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Dune Analytics MCP 服务

一个将 Dune Analytics 数据接入 AI Agent 的 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

手动安装

克隆代码库：

git clone https://github.com/kukapay/dune-analytics-mcp.git
cd dune-analytics-mcp

设置环境变量：在项目根目录中创建 .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 使用的服务。

工具用法

get_latest_result(query_id)
- 描述：获取指定 Dune 查询的最新结果。
- 输入：query_id（int）——Dune 查询的 ID。
- 输出：查询结果的 CSV 格式字符串。
- 示例：
```
get_latest_result(query_id=4853921)
```
run_query(query_id)
- 描述：执行 Dune 查询并返回结果。
- 输入：query_id（int）——要运行的 Dune 查询的 ID。
- 输出：查询结果的 CSV 格式字符串。
- 示例：
```
run_query(query_id=1215383)
```

Claude Desktop 中的示例指令

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

许可证

本项目采用 MIT License 许可协议，详情请参阅 LICENSE 文件。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。