BauplanLabs/bauplan-mcp-server

BauplanLabs

MCP-сервер для доступа AI-ассистентов к операциям Bauplan lakehouse: запросы к таблицам, инспекция схем, управление ветками и запуск пайплайнов.

Это открытый MCP-сервер, который подключает AI-ассистентов (Claude Code, Claude Desktop, Cursor) к операциям Bauplan lakehouse. Нужен разработчикам и дата-инженерам, которые хотят управлять таблицами, схемами и пайплайнами прямо из чата с ассистентом.

Ключевые возможности

  • Запросы к таблицам Bauplan lakehouse из AI-ассистента
  • Инспекция схем данных без переключения контекста
  • Управление ветками lakehouse через MCP-инструменты
  • Запуск пайплайнов Bauplan по запросу из ассистента
  • Три режима запуска: локальный, self-hosted и облачный endpoint
  • Настройка видимости инструментов через MCP_VISIBLE_TOOL_TAGS

Для каких задач подходит

  • Быстрый анализ таблиц lakehouse без написания SQL вручную
  • Просмотр и проверка схем данных при отладке пайплайнов
  • Создание и переключение веток для экспериментов с данными
  • Запуск и мониторинг пайплайнов Bauplan из диалога с ассистентом
  • Подключение корпоративного self-hosted MCP-сервера с ограниченным набором инструментов

Подробнее

Сервер построен на FastMCP и предоставляет набор инструментов, которые AI-ассистент вызывает для работы с Bauplan lakehouse. В зависимости от режима запуска набор доступных инструментов меняется: локальный сервер по умолчанию отдаёт все инструменты, self-hosted позволяет ограничить их через переменную MCP_VISIBLE_TOOL_TAGS, а публичный облачный endpoint Bauplan предоставляет только инструменты, безопасные для удалённого вызова. Аутентификация везде идёт через API-ключ Bauplan, который сервер подхватывает из локального конфигурационного файла или принимает как bearer-токен в self-hosted режиме.

От аналогичных MCP-серверов проект отличается привязкой к конкретной платформе lakehouse: инструменты покрывают именно операции Bauplan — запросы к таблицам, инспекцию схем, управление ветками и запуск пайплайнов. Если не нужен MCP-сервер, в экосистеме есть отдельный репозиторий bauplan-skills с agent playbooks и навыками для работы через CLI и SDK. Проект находится в статусе Beta, поэтому API и набор функций могут меняться без предупреждения.

При выборе стоит учитывать, что для локального запуска требуется uv и настроенный API-ключ Bauplan, а для облачного варианта — только ключ и подключение endpoint как custom connector в MCP-клиенте. Лицензия MIT позволяет использовать сервер в коммерческих целях, но статус Beta означает отсутствие гарантий стабильности интерфейса.

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

Как установить bauplan-mcp-server?

Отдельной команды установки в README нет — склонируйте репозиторий и следуйте инструкции из README:

git clone https://github.com/BauplanLabs/bauplan-mcp-server.git

Какие задачи решает bauplan-mcp-server?

Репозиторий решает задачу подключения AI-ассистентов к Bauplan lakehouse: через MCP-инструменты ассистент может запрашивать таблицы, смотреть схемы, управлять ветками и запускать пайплайны. Это убирает необходимость переключаться между чатом и отдельными CLI- или SQL-инструментами при работе с данными.

Какие AI-ассистенты поддерживаются?

В README упоминаются Claude Code, Claude Desktop и Cursor как клиенты, которые подключаются к MCP-серверу. Подойдёт любой MCP-клиент, который умеет работать с endpoint сервера.

Чем локальный запуск отличается от облачного endpoint?

Локальный сервер по умолчанию отдаёт все инструменты, а публичный облачный endpoint Bauplan — только инструменты, безопасные для удалённого вызова. В self-hosted режиме набор инструментов настраивается через MCP_VISIBLE_TOOL_TAGS.

Можно ли использовать сервер в коммерческих целях?

Да, проект распространяется под лицензией MIT, которая разрешает коммерческое использование. При этом проект в статусе Beta, поэтому API и функции могут меняться без предупреждения.

О репозитории

Язык

Лицензия

Звёзды

15

Форки

3

Открытые issues

4

Контрибьюторы

0

Создан

03.08.2025

Обновлён

19.10.2026

Теги