dune-analytics-mcp 是一个 MCP（Model Context Protocol）服务器，其作用是将 Dune Analytics 的数据桥接到 AI 智能体，使智能体能够访问和操作 Dune Analytics 上的查询数据。
用途 该服务器面向需要让 AI 智能体获取 Dune Analytics 链上或数据分析结果的场景，通过 MCP 协议把 Dune 查询能力暴露给 AI 智能体。
主要能力 它提供两个工具：
- get_latest_result：根据查询 ID 获取某个 Dune 查询的最新结果。输入为 query_id（整数），即 Dune 查询的 ID；输出为 CSV 格式的查询结果字符串。示例：get_latest_result(query_id=4853921)。
- run_query：根据查询 ID 执行 Dune 查询并返回结果。输入为 query_id（整数），即要运行的 Dune 查询的 ID；输出为 CSV 格式的查询结果字符串。示例：run_query(query_id=1215383)。 所有结果均以 CSV 格式字符串返回，便于后续处理。
使用方式 使用前需要一个有效的 Dune Analytics API 密钥（可从 Dune Analytics 获取）。 安装方式一：通过 Smithery 自动安装到 Claude Desktop。 安装方式二：手动安装。步骤包括：
- 克隆仓库： 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 一起使用的服务。
在 Claude Desktop 中的示例命令：
- "Get latest results for dune query 1215383"
- "Run dune query 1215383"
适用场景 适用于需要让 AI 智能体（如 Claude Desktop）直接获取 Dune 查询最新结果或执行指定 Dune 查询并读取 CSV 结果的场景，例如在对话中按查询 ID 拉取 Dune 数据。
限制 资料中未提供关于平台兼容范围、并发能力、结果行数上限、错误处理策略或非 Claude Desktop 客户端的支持情况等细节，暂未提供。使用前提是拥有有效的 Dune Analytics API 密钥。
许可 该项目采用 MIT 许可证，详见 LICENSE 文件。
