Consulta de Dune MCP

Versión Pitón

Un puente moderno que conecta los datos de Dune Analytics con agentes inteligentes a través del Protocolo de Control de Modelos (MCP).

Descripción general

dune-query-mcp permite la integración fluida del análisis de datos de blockchain en sus aplicaciones de IA. Al aprovechar las potentes capacidades de consulta de Dune Analytics con el Protocolo de Control de Modelos (MCP), este servicio permite a los LLM y otros sistemas de IA acceder a datos en cadena mediante interacciones sencillas en lenguaje natural.

Capacidades principales

Herramientas de recuperación de datos

Herramienta	Descripción	Caso de uso
`get_latest_result`	Recupera resultados de consultas precalculados	Acceso rápido a los datos existentes
`run_query`	Ejecuta una consulta a pedido	Análisis de datos en tiempo real

Formato de datos

Todos los datos se devuelven en formato CSV, proporcionando:

Compatibilidad universal
Fácil análisis por la mayoría de las herramientas de análisis de datos
Salida legible para humanos

Empezando

Requisitos del sistema

Python 3.10 o superior
Clave API de Dune Analytics válida ( Obtén la tuya aquí )

Configuración rápida

Clonar y navegar
git clone https://github.com/olaxbt/dune-query-mcp-mcp.git cd dune-query-mcp
Configuración del entorno
# 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
Configurar el acceso a la API
# Copy example config cp .env.example .env # Edit with your API key echo "DUNE_API_KEY=your_key_here" > .env

Uso

Ejecución del servicio

dune-query-mcp ofrece dos formas de ejecución:

Como servicio MCP

python run.py

Esto inicia el servicio MCP en el puerto predeterminado 8000.

Como servidor web

python flask_app.py

Esto proporciona acceso a la interfaz web y a los puntos finales de la API REST.

Integración con aplicaciones

Integración de clientes MCP

from mcp.client import Client # Connect to Dune-query-mcp 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)

API REST

Punto final	Método	Descripción
`/dune/health`	CONSEGUIR	Comprobación del estado del servicio
`/dune/query/{query_id}/latest`	CONSEGUIR	Recuperar los últimos resultados
`/dune/query/{query_id}/execute`	CORREO	Ejecutar una consulta

Ejemplo de llamada REST:

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

Arquitectura

dune-query-mcp/ ├── 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

Configuración avanzada

Variables de entorno

Variable	Objetivo	Por defecto
CLAVE DE API DE DUNE	Autenticación para la API de Dune	Ninguno (obligatorio)
PUERTO	Puerto del servidor	8000

Ajuste del rendimiento

Para la ejecución de consultas de gran volumen:

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

Solución de problemas

Problemas comunes y soluciones:

Problema	Solución
Errores de clave API	Asegúrese de que el archivo `.env` exista con una clave válida
Errores de tiempo de espera	Aumentar el tiempo de espera para consultas complejas
Problemas de análisis de CSV	La consulta de verificación devuelve datos tabulares correctos

Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

Bifurcar el repositorio
Crear una rama de características: git checkout -b feature/amazing-feature
Confirme sus cambios: git commit -am 'Add some amazing feature'
Empujar a la rama: git push origin feature/amazing-feature
Abrir una solicitud de extracción

Licencia

Este proyecto se publica bajo la licencia MIT. Consulte el archivo LICENSE para más detalles.

Expresiones de gratitud

Creado con FastMCP
Funcionalidad de consulta impulsada por Dune Analytics

This server cannot be installed

-

security - not tested

F

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.

Un puente que conecta los datos de la cadena de bloques de Dune Analytics con las aplicaciones de IA a través del Protocolo de Control de Modelos, lo que permite a los LLM acceder a los datos en cadena a través de interacciones de lenguaje natural.

Related MCP Servers

dune-analytics-mcp
kukapay
-
security
A
license
-
quality
A mcp server that bridges Dune Analytics data to AI agents.
Last updated -
28
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
22
67
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
23
18
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
MIT License

View all related MCP servers

Dune Query MCP