# safedb-mcp

MCP-сервер даёт ИИ-агенту ограниченный доступ к базам данных только для чтения. Подходит для безопасного просмотра схем и выполнения SQL-запросов.

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

## Что делает

safedb-mcp подключает Claude Code и другие поддерживаемые клиенты к Postgres, MySQL, MariaDB или SQLite. Агент получает инструменты для просмотра схем, таблиц и описаний, запуска запросов только для чтения, проверки плана и просмотра политики доступа.

Перед выполнением SQL сервер разбирает запрос и проверяет таблицы, соединения, CTE, вложенные подзапросы, псевдонимы и объединения. В конфигурации задаются разрешённые и запрещённые таблицы, лимиты строк, тайм-аут и маскирование PII. Попытки запросов записываются в JSONL-аудит без строк результата.

Для production нужен отдельный пользователь базы с правами только на чтение: сам сервер служит дополнительным уровнем защиты, а не заменяет минимальные привилегии. Запросы на запись, миграции, процедуры и `COPY` заблокированы.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `YOUR_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add safedb-mcp -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y @safedb/safedb-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add safedb-mcp --env YOUR_API_KEY=<YOUR_API_KEY> -- npx -y @safedb/safedb-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "safedb-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@safedb/safedb-mcp"
            ],
            "env": {
                "YOUR_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "safedb-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@safedb/safedb-mcp"
            ],
            "env": {
                "YOUR_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e YOUR_API_KEY=<YOUR_API_KEY> safedb-mcp npx -y @safedb/safedb-mcp
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Покажи доступные схемы и таблицы в подключённой базе.
- Опиши таблицу `users` и выполни безопасный запрос по заказам.
- Проверь план этого запроса и объясни, какие таблицы он затрагивает.

## Похожие
- [DBHub](https://affpapa.org/nevibecode/mcp/dbhub.md) — MCP-сервер · ★ 3730
- [whodb](https://affpapa.org/nevibecode/plugins/whodb.md) — плагин · ★ 5042
- [DB Explorer](https://affpapa.org/nevibecode/mcp/db-explorer.md) — MCP-сервер · ★ 7
- [drizzle-orm-patterns](https://affpapa.org/nevibecode/skills/drizzle-orm-patterns.md) — скилл · 5400 установок
- [prisma-expert](https://affpapa.org/nevibecode/skills/sickn33-prisma-expert.md) — скилл · 4200 установок
- [database-administrator](https://affpapa.org/nevibecode/agents/database-administrator.md) — субагент · 452 установки

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