Quack on Demand — плагин
Плагин Claude Code с руководством оператора: агент поднимает шлюз DuckDB, ведет арендаторов, права и запросы через CLI qod.
- 145 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Агент получает возможность менять арендаторов, роли и политики доступа живого шлюза.
- Шлюз открывает порты Flight SQL и веб-консоль администратора.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/quack-on-demandОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент получает возможность менять арендаторов, роли и политики доступа живого шлюза.
- Шлюз открывает порты Flight SQL и веб-консоль администратора.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Quack on Demand, открытый слой обслуживания DuckDB и DuckLake с доступом по Arrow Flight SQL, поставляется с плагином для агентов. Плагин содержит руководство оператора, по которому агент работает с живым менеджером шлюза через CLI `qod`: запускает и останавливает менеджер, управляет арендаторами и пулами, правами и политиками, смотрит узлы и выполняет SQL. Сам шлюз дает несколько арендаторов на одном сервере, защиту на уровне таблиц, строк и столбцов, несколько способов входа (база, JWT, OIDC) и веб-консоль администратора. Быстрый старт идет одной командой `uvx qod@latest serve --demo`, а для своих данных шлюз поднимают над файлом DuckDB, каталогом parquet или адресом S3.
Для кого. Инженерам данных и платформ, которые обслуживают DuckDB для нескольких команд и хотят отдать рутину администрирования шлюза агенту.
Подходит, если
- Нужно создать арендатора и пул и выдать права на таблицы одной просьбой.
- Агент проверяет состояние узлов и запускает диагностический SQL.
- Перед выкладкой проходят рабочий список по защите шлюза из `SKILL.md`.
- Демо-шлюз поднимают на ноутбуке для проверки идеи.
Не подходит, если
- Нужны распределенные соединения между узлами: каждый запрос идет на одном узле DuckDB.
- Данные измеряются терабайтами, и нужен кластер вроде Trino.
- Агенту нельзя давать доступ на изменение прав и политик.
Пример запроса к агенту
Подними демо-шлюз Quack on Demand, создай арендатора analytics с пулом из двух узлов и выдай группе только чтение таблицы sales.Ограничения
Плагин управляет живым менеджером, поэтому агент получает возможность менять арендаторов, роли и политики доступа. Выдавайте ему учетную запись с минимально нужными правами. Пароль администратора при первом запуске вводят вручную или задают через `QOD_ADMIN_PASSWORD`, он нигде не хранится. Распределенных соединений между узлами в шлюзе нет по замыслу. Руководство по укреплению защиты лежит в `plugins/qod/skills/quack-on-demand/SKILL.md`.
Как отключить. Выполните `/plugin uninstall quack-on-demand` в Claude Code или удалите скилл из каталога агента. Сам шлюз останавливают командой `uvx qod@latest stop`.
Частые вопросы
Как поставить скилл через CLI?
Выполните `qod skill install`, предварительно поставив `uv tool install qod` или `pip install qod`. Команда спросит, для какой модели ставить: Claude Code, GitHub Copilot или Gemini CLI.
Как запустить шлюз на своих данных?
Используйте `uvx qod@latest serve ./sales.duckdb`, а для каталога файлов или удаленного пути подставьте каталог или адрес `s3://`.
Где открыть панель?
Администраторский интерфейс доступен по адресу `http://localhost:20900/ui/`, порт Flight SQL 31338, порт нативного Quack 9494.
Как забыть пароль администратора?
Выполните `uvx qod@latest admin reset-password`, команда восстанавливает доступ.
Нужен ли Postgres?
Для режима `--demo` и для запуска над файлом нет: README подчеркивает, что демо работает без установки и без Postgres.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныMCP-сервер платформы Duckle: агент собирает, проверяет и запускает ETL-пайплайны на DuckDB на вашей машине
21 скилл для агентов по MotherDuck: подключение, запросы DuckDB SQL, Dives и Flights, конвейеры и аналитические приложения.
Временная песочница на DuckDB: агент загружает CSV и запрашивает данные по MCP или REST, не трогая боевую базу
Плагин DuckDB для Claude Code: SQL по CSV, Parquet и базам, чтение файлов из S3, поиск в документации и в логах сессий
Плагин Dex: агент изучает базу, строит модели dbt и семантический слой и следит за дрейфом схем с контролем затрат
DuckDB / MotherDuck MCP Server
DuckDB / MotherDuck Local MCP Server
MCP-сервер для SQL-аналитики на DuckDB: локальные файлы, база в памяти, базы на S3 и MotherDuck
Коротко о README
Шлюз хранит данные на сервере и раздает их через Flight SQL с политиками доступа. Плагин добавляет в Claude Code руководство оператора, а не отдельную копию продукта.