dune-analytics-mcp

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.