沙丘查询 MCP

DuneLink

Version Python

A modern bridge connecting Dune Analytics data to intelligent agents through Model Control Protocol (MCP).

Overview

DuneLink enables seamless integration of blockchain data analytics into your AI applications. By leveraging Dune Analytics' powerful query capabilities with the Model Control Protocol, this service allows LLMs and other AI systems to access on-chain data through simple, natural language interactions.

Core Capabilities

Data Retrieval Tools

Tool	Description	Use Case
`get_latest_result`	Retrieves pre-computed query results	Quick access to existing data
`run_query`	Executes a query on-demand	Real-time data analysis

Data Format

All data is returned in CSV format, providing:

Universal compatibility
Easy parsing by most data analysis tools
Human-readable output

Getting Started

System Requirements

Python 3.10 or higher
Valid Dune Analytics API key (Get yours here)

Quick Setup

Clone & Navigate
git clone https://github.com/olaxbt/dune-query-mcp.git cd dunelink
Environment Setup
# Create virtual environment python -m venv .venv # Activate it source .venv/bin/activate # Linux/Mac # or .venv\Scripts\activate # Windows # Install dependencies pip install -r requirements.txt
Configure API Access
# Copy example config cp .env.example .env # Edit with your API key echo "DUNE_API_KEY=your_key_here" > .env

Usage

Running the Service

DuneLink offers two ways to run:

As MCP Service

python run.py

This starts the MCP service on default port 8000.

As Web Server

python flask_app.py

This provides access to the web interface and REST API endpoints.

Integrating with Applications

MCP Client Integration

from mcp.client import Client

# Connect to DuneLink
client = Client("http://localhost:8000")

# Get latest results for a query
csv_data = client.call("get_latest_result", query_id=1234567)

# Execute a query
query_results = client.call("run_query", query_id=1234567)

REST API

Endpoint	Method	Description
`/dune/health`	GET	Service health check
`/dune/query/{query_id}/latest`	GET	Retrieve latest results
`/dune/query/{query_id}/execute`	POST	Run a query

Example REST Call:

curl -X GET http://localhost:5000/dune/query/1234567/latest

Architecture

dunelink/
├── app/                       # Application core
│   ├── __init__.py            # Flask & MCP setup
│   ├── routes/                # API endpoint definitions
│   │   └── dune_routes/       # Dune Analytics routes
│   │   └── templates/             # Web interface
│   └── templates/             # Web interface
├── config/                    # Configuration files
├── logs/                      # Runtime logs
├── flask_app.py               # Web server entry point
├── run.py                     # MCP server entry point
└── requirements.txt           # Dependencies

Advanced Configuration

Environment Variables

Variable	Purpose	Default
DUNE_API_KEY	Authentication for Dune API	None (Required)
PORT	Server port	8000

Performance Tuning

For high-volume query execution:

# Set a higher timeout for long-running queries
export DUNE_QUERY_TIMEOUT=600  # 10 minutes in seconds

Troubleshooting

Common issues and solutions:

Problem	Solution
API Key errors	Ensure `.env` file exists with valid key
Timeout errors	Increase timeout for complex queries
CSV parsing issues	Check query returns proper tabular data

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -am 'Add some amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

License

This project is released under the MIT License. See LICENSE file for details.

Acknowledgments

Built with FastMCP
Query functionality powered by Dune Analytics

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

通过模型控制协议将 Dune Analytics 区块链数据连接到 AI 应用程序的桥梁，允许 LLM 通过自然语言交互访问链上数据。

Related MCP Servers

dune-analytics-mcp
kukapay
-
security
A
license
-
quality
A mcp server that bridges Dune Analytics data to AI agents.
Last updated -
23
Python
MIT License
Bankless Onchain MCP Serverofficial
Bankless
A
security
F
license
A
quality
Implements the Model Context Protocol to allow AI models to access and interact with blockchain data, including reading contract states, retrieving events, and accessing transaction information across various networks.
Last updated -
10
621
60
TypeScript
Nodit MCP Serverofficial
noditlabs
A
security
A
license
A
quality
Connects AI agents and developers to structured blockchain data across multiple networks through Nodit's Web3 infrastructure, enabling easy querying, analysis and interaction with blockchain ecosystems without specialized development expertise.
Last updated -
9
627
13
TypeScript
Apache 2.0
Dune Analytics MCP Server
ekailabs
-
security
A
license
-
quality
A Model Context Protocol server that connects AI agents to Dune Analytics data, providing access to DEX metrics, EigenLayer statistics, and Solana token balances through structured tools.
Last updated -
2
TypeScript
MIT License

View all related MCP servers

Dune Query MCP