DuneLink

Версия Питон

Современный мост, соединяющий данные Dune Analytics с интеллектуальными агентами через протокол управления моделями (MCP).

Обзор

DuneLink обеспечивает бесшовную интеграцию аналитики данных блокчейна в ваши приложения ИИ. Используя мощные возможности запросов Dune Analytics с протоколом Model Control Protocol, этот сервис позволяет LLM и другим системам ИИ получать доступ к данным в цепочке посредством простых взаимодействий на естественном языке.

Related MCP server: Bankless Onchain MCP Server

Основные возможности

Инструменты для извлечения данных

Инструмент	Описание	Вариант использования
`get_latest_result`	Извлекает предварительно вычисленные результаты запроса	Быстрый доступ к существующим данным
`run_query`	Выполняет запрос по требованию	Анализ данных в реальном времени

Формат данных

Все данные возвращаются в формате CSV, обеспечивая:

Универсальная совместимость
Легкий анализ большинством инструментов анализа данных
Вывод, понятный человеку

Начиная

Системные требования

Python 3.10 или выше
Действительный ключ API Dune Analytics ( получите свой здесь )

Быстрая настройка

Клонировать и перемещаться
git clone https://github.com/olaxbt/dune-query-mcp.git cd dunelink
Настройка среды
# 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
Настроить API-доступ
# Copy example config cp .env.example .env # Edit with your API key echo "DUNE_API_KEY=your_key_here" > .env

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

Запуск службы

DuneLink предлагает два способа запуска:

Как служба MCP

python run.py

Это запустит службу MCP на порту по умолчанию 8000.

Как веб-сервер

python flask_app.py

Это обеспечивает доступ к веб-интерфейсу и конечным точкам REST API.

Интеграция с приложениями

Интеграция клиента MCP

from mcp.client import Client # Connect to DuneLink 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)

REST-API

Конечная точка	Метод	Описание
`/dune/health`	ПОЛУЧАТЬ	Проверка работоспособности сервиса
`/dune/query/{query_id}/latest`	ПОЛУЧАТЬ	Получить последние результаты
`/dune/query/{query_id}/execute`	ПОЧТА	Выполнить запрос

Пример вызова REST:

curl -X GET http://localhost:5000/dune/query/1234567/latest

Архитектура

dunelink/ ├── 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

Расширенная конфигурация

Переменные среды

Переменная	Цель	По умолчанию
DUNE_API_KEY	Аутентификация для API Dune	Нет (обязательно)
ПОРТ	Порт сервера	8000

Настройка производительности

Для выполнения больших объемов запросов:

# Set a higher timeout for long-running queries export DUNE_QUERY_TIMEOUT=600 # 10 minutes in seconds

Поиск неисправностей

Распространенные проблемы и решения:

Проблема	Решение
Ошибки API-ключа	Убедитесь, что файл `.env` существует с действительным ключом
Ошибки тайм-аута	Увеличить время ожидания для сложных запросов
Проблемы с анализом CSV	Проверка запроса возвращает правильные табличные данные

Внося вклад

Вклады приветствуются! Пожалуйста, выполните следующие шаги:

Форк репозитория
Создайте ветку функций: git checkout -b feature/amazing-feature
Зафиксируйте свои изменения: git commit -am 'Add some amazing feature'
Отправка в ветку: git push origin feature/amazing-feature
Открыть запрос на извлечение

Лицензия

Этот проект выпущен под лицензией MIT. Подробности см. в файле LICENSE .

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

Создано с помощью FastMCP
Функциональность запросов на базе Dune Analytics

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Dune Query MCP