Consulta de Dune MCP

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: XRPL MCP Server

Capacidades principales

Herramientas de recuperación de datos

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

1. Clonar y navegar

   git clone https://github.com/olaxbt/dune-query-mcp-mcp.git
   cd dune-query-mcp

2. 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

3. 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

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

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:

Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

1. Bifurcar el repositorio

2. Crear una rama de características: git checkout -b feature/amazing-feature

3. Confirme sus cambios: git commit -am 'Add some amazing feature'

4. Empujar a la rama: git push origin feature/amazing-feature

5. 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