Servidor MCP de Dune Analytics

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta los datos de Dune Analytics con los agentes de IA, proporcionando acceso a métricas de DEX, operadores de capa propia, estadísticas de AVS y saldos de tokens en Solana. Las herramientas utilizan los puntos de conexión predefinidos y los puntos de conexión de eco proporcionados por Dune.

Características

Herramientas :
- get_dex_pair_metrics : obtiene metadatos esenciales y datos estadísticos para un par de tokens determinado en una cadena específica
- get_token_pairs_liquidity : Encuentra el par de tokens con la mayor liquidez en USD en una cadena determinada
- get_svm_token_balances : Obtener los saldos de tokens para una dirección de billetera específica en Solana
- get_eigenlayer_avs_metrics : Obtener estadísticas para un AVS específico
- get_eigenlayer_operator_metrics : Obtener estadísticas de todos los operadores en un AVS específico
Formatos de datos : todos los resultados se devuelven en formato JSON estructurado para facilitar su procesamiento.

Prerrequisitos

Node.js 16+ o Bun 1.0+
Una clave API de Dune Analytics válida (obtenga una de Dune Analytics )

Instalación

Clonar el repositorio :
git clone https://github.com/ekailabs/dune-mcp-server.git cd dune-mcp-server
Instalar dependencias : usando Bun:
bun install
O usando npm:
npm install
Configurar variables de entorno : Cree un archivo .env en la raíz del proyecto basado en .env.example :
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

Usando Bun:

# Development mode with hot reload
bun dev

# Production mode
bun start

# Or build and run
bun build src/index.ts --outdir dist
bun dist/index.js

Usando npm:

# Development mode with hot reload
npm run dev

# Production mode
npm start

# Or build and run
npm run build
npm run start:prod

Agregar a Claude para escritorio

Para usar con Claude for Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dune": {
      "command": "bun",
      "args": [
        "/ABSOLUTE/PATH/TO/dune-mcp-server/src/index.ts",
        "stdio"
      ]
    }
  }
}

Uso de herramientas

get_dex_pair_metrics(chain, token_pair)
- Descripción : Recupera metadatos esenciales y datos estadísticos para un par de tokens determinado
- Aporte :
  - chain (cadena): la cadena de bloques para obtener las estadísticas de DEX
  - token_pair (cadena): el par de tokens para obtener las estadísticas de DEX
- Salida : objeto JSON que contiene métricas DEX
get_token_pairs_liquidity(chain)
- Descripción : Identifica el par de tokens con la mayor liquidez en USD en una cadena determinada
- Entrada : chain (cadena): la cadena de bloques para obtener las estadísticas de DEX
- Salida : objeto JSON que contiene las métricas del par de tokens superior
get_svm_token_balances(wallet_address)
- Descripción : Obtiene los saldos de una dirección de billetera específica en la cadena de bloques Solana
- Entrada : wallet_address (cadena): la dirección de la billetera para la que se obtendrá el saldo
- Salida : Matriz JSON de saldos de tokens
get_eigenlayer_avs_metrics(avs_name)
- Descripción : Obtiene las estadísticas de un AVS específico
- Entrada : avs_name (cadena): el nombre del AVS del que se obtendrán las estadísticas
- Salida : objeto JSON que contiene métricas AVS
get_eigenlayer_operator_metrics(avs_name)
- Descripción : Obtiene las estadísticas de todos los operadores en un AVS específico
- Entrada : avs_name (cadena): el nombre del AVS para el cual se obtendrán las estadísticas del operador
- Salida : objeto JSON que contiene métricas del operador

Comandos de ejemplo en Claude para escritorio

"¿Podrías por favor darme la liquidez del par de tokens 'USDC-WETH' en Ethereum?"
Muéstrame el par de tokens con mayor liquidez en arbitraje.
"¿Podrías por favor representar gráficamente la distribución de participación de los operadores de EigenDA?"
¿Cuántos participantes hay en EigenDA AVS?

Licencia

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

Expresiones de gratitud

Dune Analytics para su API
Protocolo de contexto del modelo para la especificación del protocolo

Dune Analytics MCP Server

Integrations