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