Dune Query MCP

DuneLink

Version Python

Eine moderne Brücke, die Dune Analytics-Daten über das Model Control Protocol (MCP) mit intelligenten Agenten verbindet.

Überblick

DuneLink ermöglicht die nahtlose Integration von Blockchain-Datenanalysen in Ihre KI-Anwendungen. Durch die Nutzung der leistungsstarken Abfragefunktionen von Dune Analytics mit dem Model Control Protocol ermöglicht dieser Dienst LLMs und anderen KI-Systemen den Zugriff auf On-Chain-Daten durch einfache, natürlichsprachliche Interaktionen.

Kernkompetenzen

Datenabruftools

Werkzeug	Beschreibung	Anwendungsfall
`get_latest_result`	Ruft vorberechnete Abfrageergebnisse ab	Schneller Zugriff auf vorhandene Daten
`run_query`	Führt eine Abfrage bei Bedarf aus	Echtzeit-Datenanalyse

Datenformat

Alle Daten werden im CSV-Format zurückgegeben und bieten:

Universelle Kompatibilität
Einfaches Parsen durch die meisten Datenanalysetools
Für Menschen lesbare Ausgabe

Erste Schritte

Systemanforderungen

Python 3.10 oder höher
Gültiger Dune Analytics API-Schlüssel ( Holen Sie sich Ihren hier )

Schnelle Einrichtung

Klonen und Navigieren
git clone https://github.com/olaxbt/dune-query-mcp.git cd dunelink
Umgebungs-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
API-Zugriff konfigurieren
# Copy example config cp .env.example .env # Edit with your API key echo "DUNE_API_KEY=your_key_here" > .env

Verwendung

Ausführen des Dienstes

DuneLink bietet zwei Ausführungsmöglichkeiten:

Als MCP-Dienst

python run.py

Dadurch wird der MCP-Dienst auf dem Standardport 8000 gestartet.

Als Webserver

python flask_app.py

Dies ermöglicht den Zugriff auf die Weboberfläche und die REST-API-Endpunkte.

Integration mit Anwendungen

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

Endpunkt	Verfahren	Beschreibung
`/dune/health`	ERHALTEN	Dienstintegritätsprüfung
`/dune/query/{query_id}/latest`	ERHALTEN	Aktuelle Ergebnisse abrufen
`/dune/query/{query_id}/execute`	POST	Ausführen einer Abfrage

Beispiel für einen REST-Aufruf:

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

Architektur

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

Erweiterte Konfiguration

Umgebungsvariablen

Variable	Zweck	Standard
DUNE_API_KEY	Authentifizierung für Dune API	Keine (Erforderlich)
HAFEN	Server-Port	8000

Leistungsoptimierung

Für die Ausführung von Abfragen mit hohem Volumen:

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

Fehlerbehebung

Häufige Probleme und Lösungen:

Problem	Lösung
API-Schlüsselfehler	Stellen Sie sicher, dass `.env` Datei mit gültigem Schlüssel vorhanden ist
Timeout-Fehler	Erhöhen Sie das Timeout für komplexe Abfragen
Probleme beim CSV-Parsing	Überprüfen Sie, ob die Abfrage korrekte Tabellendaten zurückgibt

Beitragen

Beiträge sind willkommen! Bitte folgen Sie diesen Schritten:

Forken Sie das Repository
Erstellen Sie einen Feature-Zweig: git checkout -b feature/amazing-feature
Übernehmen Sie Ihre Änderungen: git commit -am 'Add some amazing feature'
Pushen zum Zweig: git push origin feature/amazing-feature
Öffnen einer Pull-Anfrage

Lizenz

Dieses Projekt wird unter der MIT-Lizenz veröffentlicht. Weitere Informationen finden Sie in der Datei LICENSE .

Danksagung

Erstellt mit FastMCP
Abfragefunktionalität unterstützt durch Dune Analytics

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

Eine Brücke, die Blockchain-Daten von Dune Analytics über das Model Control Protocol mit KI-Anwendungen verbindet und LLMs so den Zugriff auf On-Chain-Daten über natürliche Sprachinteraktionen ermöglicht.

Related MCP Servers

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
45
30
TypeScript
Hashkey MCP Serverofficial
HashkeyHSK
-
security
-
license
-
quality
A Model Context Protocol server that provides onchain tools for AI applications to interact with the Hashkey Network, enabling cryptocurrency transfers, smart contract deployment, and blockchain interactions.
Last updated -
TypeScript
MIT License
Solana Model Context Protocol (MCP) Server
omaidf
-
security
F
license
-
quality
A Solana blockchain interaction server that allows AI tools to query blockchain data using natural language, access structured token information, and generate human-readable explanations of complex blockchain concepts.
Last updated -
7
Python
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 -
8
19
6
TypeScript
Apache 2.0

View all related MCP servers