Servidor MCP de Dune Analytics

Un servidor mcp que conecta los datos de Dune Analytics con los agentes de IA.

Características

• Herramientas :

  • get_latest_result : obtiene los últimos resultados de una consulta de Dune por ID.

  • run_query : ejecuta una consulta de Dune por ID y recupera resultados.

• Salida CSV : todos los resultados se devuelven como cadenas con formato CSV para facilitar el procesamiento.

Prerrequisitos

• Python 3.10+

• Una clave API de Dune Analytics válida (obtenga una de Dune Analytics )

Instalación

1. Clonar el repositorio :

   git clone https://github.com/kukapay/dune-analytics-mcp.git cd dune-analytics-mcp

2. Configurar variables de entorno : Cree un archivo .env en la raíz del proyecto:

   DUNE_API_KEY=your_api_key_here

   Alternativamente, configúrelo como una variable de entorno del sistema:

   export DUNE_API_KEY="your_api_key_here"

Uso

Ejecución del servidor

• Modo de desarrollo :

  mcp dev main.py

  Esto inicia el servidor con recarga en caliente para el desarrollo.

• Instalar para Claude Desktop :

  mcp install main.py --name "Dune Analytics"

  Instala el servidor como un servicio para su uso con Claude Desktop.

Uso de herramientas

1. get_latest_result(query_id)

   • Descripción : Recupera los últimos resultados de una consulta de Dune específica.

   • Entrada : query_id (int) – El ID de la consulta de Dune.

   • Salida : cadena con formato CSV de los resultados de la consulta.

   • Ejemplo :

     get_latest_result(query_id=4853921)

2. run_query(query_id)

   • Descripción : Ejecuta una consulta de Dune y devuelve los resultados.

   • Entrada : query_id (int): el ID de la consulta de Dune que se ejecutará.

   • Salida : cadena con formato CSV de los resultados de la consulta.

   • Ejemplo :

     run_query(query_id=1215383)

Comandos de ejemplo en Claude Desktop

• Obtener los últimos resultados de la consulta de dunas 1215383

• "Ejecutar consulta de dunas 1215383"

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.