SkillFoxx
Telegram

Ragstar MCP

Ragstar отвечает на вопросы по dbt-проекту в чате и Slack, а его MCP-сервер дает Claude поиск по моделям и их SQL

  • 180 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Стек из Django, Next.js, Redis и PostgreSQL хранит ключи моделей и токены dbt Cloud, Slack и GitHub
  • Содержимое dbt-моделей и SQL уходит провайдерам LLM для эмбеддингов и ответов
  • Значение ALLOWED_ORIGINS=* из примера открывает MCP-сервер для любых источников
Все причины и проверки

pragunbhutani/dbt-llm-agentАвтор:pragunbhutani

Установка

Ручная установка

docker compose up --build -d

Предварительно скопируйте `.env.example` в `.env` и задайте NEXTAUTH_SECRET, NEXTAUTH_URL, NEXT_PUBLIC_API_URL. Затем `docker compose exec backend-django uv run python manage.py migrate`.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Стек из Django, Next.js, Redis и PostgreSQL хранит ключи моделей и токены dbt Cloud, Slack и GitHub
  • Содержимое dbt-моделей и SQL уходит провайдерам LLM для эмбеддингов и ответов
  • Значение ALLOWED_ORIGINS=* из примера открывает MCP-сервер для любых источников

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Ragstar подключается к dbt-проекту, строит базу знаний из моделей и документации и отвечает на вопросы на обычном языке в веб-панели или в Slack командой `/ask`. Под капотом PostgreSQL с pgvector для поиска по смыслу, эмбеддинги и модели OpenAI, Anthropic или Google, бэкенд на Django и фронтенд на Next.js. К агентам относится встроенный MCP-сервер для самостоятельной установки. Он отдает четыре инструмента: `list_dbt_models`, `search_dbt_models`, `get_model_details` и `get_project_summary`. Через них клиент вроде Claude.ai находит модели по смыслу, читает их SQL и происхождение данных и видит структуру подключенных проектов. Вход идет через OAuth 2.0 с PKCE, данные ограничены организацией пользователя. Проект источников dbt добавляют из dbt Cloud по сервисному токену, из GitHub или архивом. Весь стек поднимается через Docker Compose, веб-панель открывается на порту 3000, а MCP-сервер слушает порт 8080.

Для кого. Аналитикам и инженерам данных, у которых есть dbt-проект и которые готовы развернуть Docker-стек, чтобы коллеги задавали вопросы по моделям без SQL.

Подходит, если

  • Коллеги задают в Slack одни и те же вопросы о том, какая модель считает выручку, и их нужно разгрузить
  • Claude.ai должен находить dbt-модели по смыслу и показывать их SQL и происхождение данных
  • Документация dbt разрослась, и поиск по названиям уже не помогает
  • Доступ нескольких людей должен идти через общий вход с изоляцией данных по организации
  • Хочется проверить SQL, который ответ собрал из моделей, второй моделью

Не подходит, если

  • Достаточно быстрого доступа к dbt из терминала: у dbt Labs есть официальный MCP-сервер без Docker-стека
  • На машине нельзя запускать Docker, PostgreSQL с pgvector и Redis
  • Облачный MCP без самостоятельного хостинга: MCP доступен только на своей установке
  • Проект dbt не из dbt Cloud, GitHub или архива

Пример запроса к агенту

Найди в моих dbt-моделях все, что связано с выручкой по клиентам, и покажи SQL самой подходящей.

MCP

Транспорт
http
Авторизация
OAuth

Переменные окружения

MCP_AUTHORIZATION_BASE_URL обязательная
Адрес Django-бэкенда для OAuth, в примере http://localhost:8000
DJANGO_BACKEND_URL обязательная
Адрес бэкенда, к которому обращается MCP-сервер
ALLOWED_ORIGINS
Разрешенные источники CORS, в примере `*`, для продакшена задайте конкретные
NEXTAUTH_SECRET обязательная, секрет
Секрет подписи сессионных cookie фронтенда, в README создается командой openssl rand -base64 32
LLM_OPENAI_API_KEY секрет
Ключ OpenAI, нужен для каждого провайдера моделей, который вы используете

Ограничения

  • Ragstar в публичной бете: автор предупреждает о быстрых изменениях и шероховатостях, а в одном из примечаний пишет, что MCP-сервер временно отключен ради доработки стриминга. Раздел про MCP при этом описывает его запуск, поэтому состояние проверьте на своей сборке.
  • MCP работает только на самостоятельно развернутой установке: каждому клиенту нужен собственный экземпляр сервера.
  • Нужны ключи провайдеров моделей и переменные NEXTAUTH_SECRET, NEXTAUTH_URL, NEXT_PUBLIC_API_URL. Интеграции с Metabase и Snowflake экспериментальные.

Как отключить. Остановите стек командой `docker compose down`, с флагом `-v` удаляется и база. Подключение в Claude.ai снимите в настройках серверов MCP.

Частые вопросы

Что такое Ragstar и при чем тут MCP?

Ragstar — самостоятельно развертываемое приложение, которое строит базу знаний по dbt-проекту и отвечает на вопросы. MCP-сервер входит в тот же Docker-стек и отдает эту базу знаний клиентам вроде Claude.ai.

Какие инструменты отдает MCP-сервер Ragstar?

Четыре: `list_dbt_models` для списка и фильтров, `search_dbt_models` для поиска по смыслу, `get_model_details` для SQL и происхождения данных и `get_project_summary` для обзора проектов.

Как подключить Ragstar к Claude.ai?

Поднимите стек через `docker compose up -d`, добавьте в Claude.ai сервер по адресу http://localhost:8080 или вашему публичному URL и включите OAuth 2.0. Claude.ai перенаправит на вход Ragstar, после входа соединение привязывается к вашей организации.

Можно ли пользоваться MCP без собственного хостинга?

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

Какие модели использует Ragstar?

Модели OpenAI, Anthropic и Google. Ключи задают переменными LLM_OPENAI_API_KEY, LLM_ANTHROPIC_API_KEY и LLM_GOOGLE_API_KEY, и нужны только для провайдеров, которыми вы пользуетесь.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Плагин Dex: агент изучает базу, строит модели dbt и семантический слой и следит за дрейфом схем с контролем затрат

ПлагинРасширенный доступ119

dbt MCP

dbt-mcp

Официальный

Официальный сервер MCP от dbt Labs: Semantic Layer, метаданные проекта, запуск команд dbt и SQL к хранилищу из агента

MCP-серверРасширенный доступ621

dbt-doctor оценивает здоровье проекта dbt, профилирует модели, находит дрейф схемы и дописывает документацию в schema.yml.

MCP-серверРасширенный доступ105
Официальный

MCP-сервер Byaan передает Claude Code и Cursor вопросы к вашим базам данных и возвращает запросы с результатами в режиме чтения.

MCP-серверРасширенный доступ96
Официальный

Официальный MCP-сервер Graphlit: агент собирает материалы из Slack, GitHub, почты и сайтов в базу знаний и ищет по ней

MCP-серверШирокий доступ379
Официальный

Встроенный MCP-сервер мультимодельной СУБД ArcadeDB: агент читает граф, документы и векторы, а запись включается по операциям.

MCP-серверШирокий доступ1,3 тыс.

Коротко о README

README ведет от описания и скриншотов к запуску в две команды через Docker Compose, таблицам переменных окружения, первому входу и добавлению dbt-проекта. Затем описаны управление стеком, локальная разработка без Docker и большой раздел про MCP: инструменты, настройка, схема OAuth и подключение Claude.ai.

Бейдж для README

Сообщить о проблеме