Skip to main content
Glama
deenesjakoruzh

Dune Query MCP

by olaxbt
GitHub
Python
5
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Consulta de Dune MCP

VersiónPitó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

HerramientaDescripciónCaso de uso
get_latest_resultRecupera resultados de consultas precalculadosAcceso rápido a los datos existentes
run_queryEjecuta una consulta a pedidoAná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

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
Punto finalMétodoDescripción
/dune/healthCONSEGUIRComprobación del estado del servicio
/dune/query/{query_id}/latestCONSEGUIRRecuperar los últimos resultados
/dune/query/{query_id}/executeCORREOEjecutar 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

VariableObjetivoPor defecto
CLAVE DE API DE DUNEAutenticación para la API de DuneNinguno (obligatorio)
PUERTOPuerto del servidor8000

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:

ProblemaSolución
Errores de clave APIAsegúrese de que el archivo .env exista con una clave válida
Errores de tiempo de esperaAumentar el tiempo de espera para consultas complejas
Problemas de análisis de CSVLa consulta de verificación devuelve datos tabulares correctos

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

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.

  1. Descripción general
    1. Capacidades principales
      1. Herramientas de recuperación de datos
      2. Formato de datos
    2. Empezando
      1. Requisitos del sistema
      2. Configuración rápida
    3. Uso
      1. Ejecución del servicio
      2. Integración con aplicaciones
    4. Arquitectura
      1. Configuración avanzada
        1. Variables de entorno
        2. Ajuste del rendimiento
      2. Solución de problemas
        1. Contribuyendo
          1. Licencia
            1. Expresiones de gratitud

              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
                • Linux
                • Apple

              • 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
                48
                9
                TypeScript
                Apache 2.0
                • Apple

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/olaxbt/dune-query-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server