SpotDB — SQL-песочница на DuckDB для агентов
SpotDB
Временная песочница на DuckDB: агент загружает CSV и запрашивает данные по MCP или REST, не трогая боевую базу
- 21 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент выполняет SQL в песочнице, включая `write_query` с INSERT, UPDATE и DELETE
- Загруженный CSV может содержать персональные данные, и агент увидит их целиком
Установка
- Работает в
Ручная установка
brew tap aliengiraffe/spaceship && brew install spotdbУстановка из README, затем запуск командой spotdb.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент выполняет SQL в песочнице, включая `write_query` с INSERT, UPDATE и DELETE
- Загруженный CSV может содержать персональные данные, и агент увидит их целиком
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SpotDB запускает на вашей машине временную базу DuckDB и закрывает ее программным интерфейсом с защитой. Агент и скрипты работают только с этой копией данных, поэтому боевые базы остаются в стороне. CSV-файл загружается одним запросом, схему и типы столбцов сервер определяет сам. К данным можно обратиться двумя путями. REST API слушает порт 8080 и принимает загрузку файлов и SQL-запросы, а MCP-сервер на порту 8081 отдает те же возможности агенту по SSE и Streamable HTTP. Среди инструментов MCP есть `read_query`, `write_query`, `create_datasource`, `list_datasources`, `load_datasource`, `describe_datasource` и `append_insight` для заметок по результатам анализа. Снимки сохраняют состояние данных, к нему можно вернуться позже. Для просмотра без агента есть веб-интерфейс Explorer по адресу localhost:8080/explorer, где можно загрузить файл и выполнить запрос вручную.
Для кого. Аналитикам и разработчикам, которые хотят дать агенту поработать с выгрузкой из CSV, не открывая ему доступ к рабочей базе.
Подходит, если
- Выгрузку из CRM надо разобрать SQL-запросами, а подключать агента к самой CRM нельзя
- Нужна быстрая аналитика по CSV без создания схемы и поднятия отдельной базы
- Агент должен вести заметки к результатам анализа, и они лягут в памятку по данным
- Перед сложным преобразованием стоит сохранить снимок и при ошибке вернуться к нему
Не подходит, если
- Данные лежат в рабочей базе и обновляются постоянно: песочница работает с загруженной копией
- Нужна база для приложения: хранилище временное и рассчитано на анализ, а не на сервис
- Сервер нужно открыть для нескольких пользователей: в README показан один экземпляр на машине
- Файлы не в CSV: в README описана загрузка только этого формата
Пример запроса к агенту
Загрузи файл orders.csv в песочницу, опиши структуру таблицы и найди пять клиентов с самой большой суммой заказов.MCP
- Транспорт
- http, sse
- Авторизация
- не нужна
Переменные окружения
X-API-Keyсекрет- Необязательный ключ для авторизации запросов
Ограничения
Хранилище временное: данные в песочнице живут, пока она запущена, а для сохранения нужны снимки.
Текст README и документация противоречат друг другу по доступу на запись: документация называет среду доступной только для чтения, но среди инструментов MCP есть `write_query` для INSERT, UPDATE и DELETE. Права агента проверьте по инструментам, а не по описанию.
Для Claude Code подключение идет через мост `mcp-remote`, поэтому нужен Node.js. Установка через Homebrew, под другие системы в README нет отдельных команд.
Как отключить. Остановите процесс spotdb и удалите сервер командой claude mcp remove spotdb. Вместе с остановкой исчезают данные временной песочницы.
Частые вопросы
Как поставить SpotDB для Claude Code?
Выполните brew tap aliengiraffe/spaceship и brew install spotdb, запустите команду spotdb, затем claude mcp add spotdb -s user -- npx -y mcp-remote http://localhost:8081/stream. Команда claude должна быть установлена заранее.
Как загрузить CSV?
Отправьте файл POST-запросом на http://localhost:8080/api/v1/upload с полями table_name, has_header и csv_file. После загрузки запросы идут на /api/v1/query или через MCP.
Чем SpotDB отличается от подключения агента к базе напрямую?
Агент видит только загруженную копию в DuckDB, а доступ идет через API с ограничениями. Боевые данные и их учетные записи остаются на вашей стороне.
Есть ли у сервера ключ?
В описании реестра MCP указан необязательный ключ запросов X-API-Key. Для локального запуска из README он не требуется.
Где посмотреть данные без агента?
Откройте http://localhost:8080/explorer: там можно загрузить файлы и выполнить запросы вручную.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер платформы Duckle: агент собирает, проверяет и запускает ETL-пайплайны на DuckDB на вашей машине
DuckDB / MotherDuck MCP Server
DuckDB / MotherDuck Local MCP Server
MCP-сервер для SQL-аналитики на DuckDB: локальные файлы, база в памяти, базы на S3 и MotherDuck
Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других
Десктопное рабочее место для SQL с встроенным MCP-сервером: агент читает схему и выполняет запросы в том же клиенте, где работаете вы
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| SpotDB — SQL-песочница на DuckDB для агентов (эта карточка) | да | не нужна | 21 | |
| DuckDB / MotherDuck MCP Server | да | не нужна | 539 | сервер для готовых файлов DuckDB и облака MotherDuck, без загрузки CSV и снимков |
| duckdb-skills | нет | 616 | набор скиллов для работы с DuckDB в агенте, а не отдельный сервер песочницы |
Коротко о README
README начинается с быстрого старта: установка через Homebrew, запуск сервера, загрузка CSV запросом curl, SQL-запрос и подключение MCP к Claude Code. Подробная документация вынесена в DOCS.md, а в описании репозитория проект называют облегченной песочницей данных с защитой для рабочих процессов с ИИ.