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.

Related MCP server: Bankless Onchain MCP Server

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?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Dune Query MCP