# spotdb

Создаёт изолированную временную песочницу с данными для ИИ-агентов. Защищает рабочие базы от случайных изменений при анализе таблиц.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21
- Автор: aliengiraffe
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/aliengiraffe/spotdb
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/spotdb

## Что делает

Сервер разворачивает изолированную среду для работы с таблицами через протокол MCP и REST API. Агент выполняет SQL-запросы к загруженным данным, не получая прямого доступа к боевой инфраструктуре. Для ручной проверки таблиц предусмотрен веб-интерфейс Explorer UI по адресу `http://localhost:8080/explorer`.

Внутри есть механизм снимков состояния. Они позволяют сохранять контрольные точки таблиц и возвращаться к ним при сбоях в аналитических сценариях. Данные передаются через POST-запросы к API, в том числе обычные файлы CSV с заголовками.

Для работы сервера через MCP потребуется Docker. Без запущенного демона Docker вызов контейнера завершится ошибкой.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add spotdb -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0
```

### Codex

**Командой платформы**
```bash
codex mcp add spotdb -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spotdb": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/aliengiraffe/spotdb:0.1.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "spotdb": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/aliengiraffe/spotdb:0.1.0"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add spotdb docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0
```

## Когда брать
- изолировать анализ данных от рабочей базы
- сохранять снимки таблиц для отката изменений
- выполнять SQL-запросы к временным CSV-файлам
- просматривать структуру таблиц через браузерный интерфейс

## Примеры запросов агенту
- Выполни SQL-запрос к таблице mytable и покажи первые 10 строк.
- Загрузи данные из data.csv во временную песочницу spotdb.
- Создай снимок текущего состояния таблиц перед внесением изменений.

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [dbx](https://affpapa.org/nevibecode/mcp/dbx.md) — MCP-сервер · ★ 27669
- [Metabase](https://affpapa.org/nevibecode/mcp/metabase.md) — MCP-сервер · ★ 49845

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md