DuneLink

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

Обзор

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

Related MCP server: Bankless Onchain MCP Server

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

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

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

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

• Универсальная совместимость

• Легкий анализ большинством инструментов анализа данных

• Вывод, понятный человеку

Начиная

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

• Python 3.10 или выше

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

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

1. Клонировать и перемещаться

   git clone https://github.com/olaxbt/dune-query-mcp.git
   cd dunelink

2. Настройка среды

   # 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

3. Настроить 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

Пример вызова 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

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

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

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

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

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

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

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

Внося вклад

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

1. Форк репозитория

2. Создайте ветку функций: git checkout -b feature/amazing-feature

3. Зафиксируйте свои изменения: git commit -am 'Add some amazing feature'

4. Отправка в ветку: git push origin feature/amazing-feature

5. Открыть запрос на извлечение

Лицензия

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

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

• Создано с помощью FastMCP

• Функциональность запросов на базе Dune Analytics