MiniLake MCP
Локальный эмулятор Databricks API с MCP-сервером на 67 инструментов: агент работает с SQL и заданиями без рабочего пространства
- 142 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Инструменты MCP выполняют произвольный SQL и запускают контейнеры Docker на вашей машине.
- Аутентификации нет, принимается любой токен: опубликованный порт с `/mcp` равен выдаче оболочки на машине.
Установка
- Работает в
Ручная установка
pip install minilakeПервая команда запуска из README ставит эмулятор. Для MCP нужен extra: `pip install 'minilake[mcp]'`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты MCP выполняют произвольный SQL и запускают контейнеры Docker на вашей машине.
- Аутентификации нет, принимается любой токен: опубликованный порт с `/mcp` равен выдаче оболочки на машине.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MiniLake поднимает на localhost эмулятор REST API Databricks, чтобы писать и проверять код на `databricks-sdk`, CLI и Terraform без настоящего рабочего пространства. SQL выполняется на DuckDB, внешние таблицы Delta лежат как Parquet с `_delta_log/`, а задания запускают `spark-submit` в соседнем контейнере Docker. Остальные части API хранят и возвращают данные либо отвечают `501 NOT_IMPLEMENTED`. MCP-сервер включается переменной `MINILAKE_MCP=1` и отвечает по адресу `/mcp` на том же порту, без отдельного процесса. Он дает 67 инструментов, часть из которых сворачивает цепочку из четырех вызовов в один, 8 ресурсов с правилами для агента и 4 заготовки запросов. Агент получает инструкции еще до первого действия: например, что диалект SQL здесь DuckDB, а не Spark. Слой MCP вызывает собственный HTTP API эмулятора, поэтому ошибка инструмента совпадает с ошибкой обычного клиента SDK.
Для кого. Инженерам данных, которые пишут код под Databricks и хотят, чтобы агент гонял SQL и задания локально, а не в платном рабочем пространстве.
Подходит, если
- Агент пишет скрипты на `databricks-sdk`, и их надо запускать без доступа к рабочему пространству.
- Конфигурацию Terraform или Asset Bundles проверяют на локальной копии API.
- CI гоняет тесты кода под Databricks без облачных затрат.
- Агенту нужны каталоги, схемы и таблицы, которые можно создавать и ломать без последствий.
Не подходит, если
- Нужно проверить права доступа и гранты: эмулятор их хранит, но не применяет.
- Код использует Spark SQL, а не диалект DuckDB.
- Сервер собираются открыть нескольким людям или в сети.
Пример запроса к агенту
Создай каталог sales со схемой store, таблицей orders и тремя строками, затем выполни запрос с группировкой по клиентам.MCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
MINILAKE_MCPобязательная- Значение 1 включает обслуживание MCP по адресу /mcp.
MINILAKE_MCP_MAX_ROWS- Предел строк для run_sql, по умолчанию 200.
MINILAKE_MCP_ALLOWED_HOSTS- Список разрешенных значений Host, нужен при обращении не по loopback-имени.
Ограничения
Эмулятор рассчитан на одного разработчика на localhost: аутентификации нет, принимается любой токен. Инструменты MCP выполняют произвольный SQL и запускают контейнеры Docker, поэтому порт с `/mcp` нельзя публиковать наружу, адрес `127.0.0.1` оставляют как есть. Не реализованы Repos, DLT, Model Registry, Vector Search, Lakeview и Genie, Delta Sharing. Управляемые таблицы живут в DuckDB без файлов, и Spark их не видит. Зеленый локальный прогон не заменяет проверку в настоящем Databricks.
Как отключить. Выполните `claude mcp remove minilake` и остановите процесс `minilake` или контейнер Docker. Без `MINILAKE_MCP=1` адрес `/mcp` не обслуживается.
Частые вопросы
Как подключить MiniLake к Claude Code?
Запустите эмулятор с `MINILAKE_MCP=1`, затем выполните `claude mcp add --transport http minilake http://localhost:8000/mcp`. Команда `claude mcp list` должна показать подключение. В репозитории есть и готовый `.mcp.json` для проекта.
Как включить MCP и почему он выключен по умолчанию?
Переменной `MINILAKE_MCP=1`. Инструменты исполняют произвольный SQL и запускают Docker, а эмулятор принимает любой токен, поэтому по умолчанию `/mcp` отключен.
Сколько строк возвращает `run_sql`?
До 200 строк по умолчанию. Лимит меняет `MINILAKE_MCP_MAX_ROWS`, чтобы `SELECT *` по большой таблице не заполнил контекст агента.
Работает ли эмулятор без интернета?
Да. Образ Docker ничего не скачивает во время работы, поэтому подходит для офлайн-использования.
Как запустить MiniLake в Docker?
Выполните `docker run -p 8000:8000 ghcr.io/dmux/minilake:latest`. Для MCP добавьте `-e MINILAKE_MCP=1`: нужный extra в образе уже есть.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Dremio: агент смотрит таблицы, ищет закономерности в данных и разбирает нагрузку кластера.
Набор Databricks Field Engineering для агентов: установщик скиллов Databricks, MCP-сервер и визуальный Builder App
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
Десктопное рабочее место для SQL с встроенным MCP-сервером: агент читает схему и выполняет запросы в том же клиенте, где работаете вы
Один бинарник MCP-сервера для MySQL, MariaDB, PostgreSQL и SQLite: запросы только на чтение по умолчанию и маскировка ПДн
DuckDB / MotherDuck MCP Server
DuckDB / MotherDuck Local MCP Server
MCP-сервер для SQL-аналитики на DuckDB: локальные файлы, база в памяти, базы на S3 и MotherDuck
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MiniLake (эта карточка) | нет | не нужна | 142 | |
| Databricks AI Tools | нет | 384 | официальные скиллы для работы с настоящей платформой Databricks; MiniLake заменяет платформу локальным эмулятором | |
| DuckDB / MotherDuck MCP Server | да | не нужна | 539 | дает SQL-аналитику на DuckDB напрямую; MiniLake надстраивает над DuckDB совместимый с Databricks REST API |
Коротко о README
Эмулятор покрывает большую часть REST API Databricks и проверяется на настоящих `databricks-sdk`, провайдере Terraform и `databricks bundle`. Документация описывает конфигурацию, веб-редактор SQL по адресу `/ui/` и статус каждого сервиса.