Сервер MCP Dune Analytics

Сервер Model Context Protocol (MCP), который связывает данные Dune Analytics с агентами AI, предоставляя доступ к метрикам DEX, операторам EigenLayer и статистике AVS, а также балансам токенов на Solana. Инструменты используют предустановленные конечные точки и конечные точки эха, предоставляемые Dune.

Функции

• Инструменты :

  • get_dex_pair_metrics : получение основных метаданных и статистических данных для заданной пары токенов в определенной цепочке

  • get_token_pairs_liquidity : найти пару токенов с самой высокой ликвидностью в долларах США в заданной цепочке

  • get_svm_token_balances : Получить балансы токенов для определенного адреса кошелька на Solana

  • get_eigenlayer_avs_metrics : Получить статистику для определенного AVS

  • get_eigenlayer_operator_metrics : Получить статистику для всех операторов в определенном AVS

• Форматы данных : все результаты возвращаются в структурированном формате JSON для удобства обработки.

Related MCP server: AMOCA Solana MCP Server

Предпосылки

• Node.js 16+ или Bun 1.0+

• Действительный ключ API Dune Analytics (получите его у Dune Analytics )

Установка

1. Клонировать репозиторий :

   git clone https://github.com/ekailabs/dune-mcp-server.git
   cd dune-mcp-server

2. Установка зависимостей : Использование Bun:

   bun install

   Или с помощью npm:

   npm install

3. Настройка переменных среды : Создайте файл .env в корне проекта на основе .env.example :

   DUNE_API_KEY=your_api_key_here

   Либо установите его как системную переменную среды:

   export DUNE_API_KEY="your_api_key_here"

Использование

Запуск сервера

Использование булочки:

# 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

Использование npm:

# Development mode with hot reload
npm run dev

# Production mode
npm start

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

Добавить в Claude для рабочего стола

Для использования с Claude for Desktop добавьте конфигурацию сервера:

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

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

Использование инструмента

1. get_dex_pair_metrics(chain, token_pair)

   • Описание : Извлекает основные метаданные и статистические данные для заданной пары токенов.

   • Вход :

     • chain (строка) — блокчейн для получения статистики DEX

     • token_pair (string) — пара токенов, для которых необходимо получить статистику DEX.

   • Вывод : объект JSON, содержащий метрики DEX.

2. get_token_pairs_liquidity(chain)

   • Описание : Определяет пару токенов с самой высокой ликвидностью в долларах США в данной цепочке.

   • Ввод : chain (строка) — блокчейн для получения статистики DEX

   • Вывод : объект JSON, содержащий метрики топовой пары токенов.

3. get_svm_token_balances(wallet_address)

   • Описание : Получает балансы определенного адреса кошелька в блокчейне Solana.

   • Ввод : wallet_address (строка) — адрес кошелька, для которого необходимо получить баланс

   • Вывод : JSON-массив балансов токенов.

4. get_eigenlayer_avs_metrics(avs_name)

   • Описание : Получает статистику для определенного AVS.

   • Ввод : avs_name (строка) — имя AVS, для которого необходимо получить статистику.

   • Вывод : объект JSON, содержащий метрики AVS.

5. get_eigenlayer_operator_metrics(avs_name)

   • Описание : Получает статистику по всем операторам в определенном AVS.

   • Ввод : avs_name (строка) — имя AVS, для которого необходимо получить статистику оператора.

   • Вывод : объект JSON, содержащий метрики оператора.

Примеры команд в Claude для рабочего стола

• «Можете ли вы сообщить мне ликвидность пары токенов «USDC-WETH» на Ethereum?»

• «Покажите мне самую ликвидную пару токенов на арбитраже»

• «Можете ли вы построить график распределения долей операторов EigenDA?»

• «Сколько участников на EigenDA AVS»

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Запуск оценок

Пакет evals загружает клиент mcp, который затем запускает файл index.ts, поэтому нет необходимости перестраиваться между тестами. Вы можете загрузить переменные среды, указав префикс команды npx. Полную документацию можно найти здесь .

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Благодарности

• Dune Analytics для своего API

• Модель контекстного протокола для спецификации протокола