Перейти к основному содержанию
Запустите полный Agentic Data Stack локально с помощью Docker Compose, чтобы сразу после первого входа задавать вопросы по своим данным. Одной командой docker compose up вы запустите LibreChat, MCP-сервер ClickHouse, ClickHouse и Langfuse для обсервабилити.

​
Предварительные требования

  • Docker с плагином Compose (Compose v2 или новее).
  • Git для клонирования репозитория.
  • API-ключ провайдера модели (например, OpenAI, Anthropic или Google). Агенту нужна модель, чтобы отвечать на вопросы, поэтому укажите ключ при настройке или добавьте его в интерфейсе LibreChat перед первым чатом.

​
Разверните стек

1

Клонируйте репозиторий

В репозитории есть файл docker-compose.yml в корне, поэтому весь стек можно поднять одной командой. Полный список сервисов см. в разделе Архитектура.
2

Запустите скрипт подготовки демо

Скрипт создаст файл .env с учетными данными для всех сервисов, а затем предложит интерактивное меню для настройки ключей API выбранного провайдера. Эти ключи API также можно задать напрямую в файле .env. Для любого пропущенного провайдера останется значение user_provided, поэтому позже вы сможете добавить свой ключ в интерфейсе LibreChat.При первом запуске стек создает пользователя admin из .env. Логин по умолчанию: admin@admin.com / password.
Запустите generate-env.sh с этими переменными перед prepare-demo.sh:
После этого prepare-demo.sh обнаружит существующий .env и сразу перейдет к настройке ключей API.
3

Запустите сервисы в фоновом режиме

Порядок запуска регулируется автоматически. LibreChat запускается только после того, как MCP-сервер станет доступен, поэтому при первой загрузке соединение с ClickHouse уже будет готово.
4

Откройте LibreChat и войдите

Когда стек будет запущен, сервисы станут доступны в браузере:Войдите в LibreChat с учетными данными администратора из файла .env.
5

Выберите модель

По умолчанию модель уже выбрана. Если хотите ее изменить, откройте селектор моделей и выберите нужную.Если во время настройки вы не задали ключ провайдера, добавьте его в интерфейсе.
Откройте селектор моделей и нажмите Set API Key рядом с провайдером.Вставьте свой ключ в диалоговое окно и нажмите Submit. Вы можете задать срок действия или сделать ключ бессрочным.
6

Выберите MCP-сервер

Стек заранее настраивает свои MCP-серверы в librechat.yaml LibreChat. В поле ввода сообщения нажмите MCP Servers и выберите ClickHouse-Local.Чтобы использовать сервис ClickHouse Cloud, выберите ClickHouse-Cloud.
7

Задайте свой первый вопрос

Например:
Какие базы данных и таблицы доступны и сколько строк в самой большой таблице?
Агент использует инструменты MCP-сервера, чтобы получить список баз данных и таблиц, выполнять запросы к ClickHouse в режиме только для чтения и формировать ответ на основе результатов. Вам не нужно писать SQL.

​
Остановить или сбросить стек

Остановите сервисы, ничего не удаляя:
Чтобы удалить все контейнеры и очистить все тома, чтобы начать с чистого листа, используйте скрипт сброса стека:

​
Архитектура

docker-compose.yml — это небольшая точка входа, которая включает четыре файла Compose: Есть две особенности, благодаря которым запуск одной командой работает:
  • Проверки работоспособности и порядок запуска. Compose использует проверки работоспособности, чтобы выстроить последовательность запуска. MCP-сервер ждёт ClickHouse, а LibreChat — MCP-сервер.
  • Общий файл окружения. В .env хранятся учётные данные и параметры подключения для каждого сервиса; они согласованы между собой, чтобы сервисы могли взаимодействовать друг с другом. Например, MCP-сервер подключается к ClickHouse с учётными данными ClickHouse из .env. LibreChat получает LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY и LANGFUSE_BASE_URL, поэтому каждая сессия по умолчанию трассируется в Langfuse.
В этом stack ClickHouse выполняет две роли: это и бэкенд хранилища Langfuse, и база данных, к которой ваш агент отправляет запросы через MCP-сервер.

​
Следующие шаги

  • Узнайте, за что отвечает каждый компонент этого стека: MCP-сервер ClickHouse, LibreChat и Langfuse.
  • См. обзор, чтобы понять, как всё это работает вместе.
  • Чтобы опробовать стек на публичных датасетах без установки, воспользуйтесь AgentHouse — размещённой демоверсией.
Последнее изменение 2 июля 2026 г.