spotdb — MCP-сервер для Claude Code: что делает и как установить
Создаёт изолированную временную песочницу с данными для ИИ-агентов. Защищает рабочие базы от случайных изменений при анализе таблиц.
claude mcp add spotdb -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0Что делает spotdb
Сервер разворачивает изолированную среду для работы с таблицами через протокол MCP и REST API. Агент выполняет SQL-запросы к загруженным данным, не получая прямого доступа к боевой инфраструктуре. Для ручной проверки таблиц предусмотрен веб-интерфейс Explorer UI по адресу http://localhost:8080/explorer.
Внутри есть механизм снимков состояния. Они позволяют сохранять контрольные точки таблиц и возвращаться к ним при сбоях в аналитических сценариях. Данные передаются через POST-запросы к API, в том числе обычные файлы CSV с заголовками.
Для работы сервера через MCP потребуется Docker. Без запущенного демона Docker вызов контейнера завершится ошибкой.
Какие задачи решает
- изолировать анализ данных от рабочей базы
- сохранять снимки таблиц для отката изменений
- выполнять SQL-запросы к временным CSV-файлам
- просматривать структуру таблиц через браузерный интерфейс
Примеры запросов агенту
- Выполни SQL-запрос к таблице mytable и покажи первые 10 строк.
- Загрузи данные из data.csv во временную песочницу spotdb.
- Создай снимок текущего состояния таблиц перед внесением изменений.
Как установить spotdb
Командой платформы
claude mcp add spotdb -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0Командой платформы
codex mcp add spotdb -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0Файл настроек
{
"mcpServers": {
"spotdb": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/aliengiraffe/spotdb:0.1.0"
]
}
}
}Файл настроек
{
"servers": {
"spotdb": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/aliengiraffe/spotdb:0.1.0"
]
}
}
}Командой платформы
gemini mcp add spotdb docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о spotdb
Как установить spotdb в Claude Code?
Выполните команду claude mcp add spotdb -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0. На компьютере должен быть установлен и запущен Docker.
Зачем нужен spotdb?
Инструмент создаёт временную песочницу для безопасных экспериментов с данными. Агенты и скрипты исследуют таблицы без подключения к боевым базам.
Как загрузить данные в песочницу?
Отправьте CSV-файл через POST-запрос на http://localhost:8080/api/v1/upload с параметрами table_name и has_header. Также можно воспользоваться веб-страницей http://localhost:8080/explorer.
