🛡️ Database Sentinel

Аудит безопасности для вашего бэкенда базы данных. Спросите «проверь мою базу данных» и получите отчёт с оценкой и точным кодом исправления.

Работает как Claude Skill (Supabase, MongoDB), как MCP-сервер только для чтения для любого AI-клиента или как CLI-агент, использующий вашу собственную модель (оба для Supabase).

→ Настройка и использование MCP-сервера

→ Не хотите запускать самостоятельно? Locksoup — это хостинговая версия: аудит безопасности Supabase с запланированными повторными проверками и оповещениями.

Журнал изменений

2026-10-01 (v1.0.1)

• Исправлено: политика UPDATE без WITH CHECK больше не сообщается как позволяющая пользователям переназначать владельца строки (Postgres повторно использует USING в качестве проверки). Метка Q8 и промпт агента утверждали обратное, что приводило к ложным находкам массового присваивания на реальных проектах.
• Бенчмарк: новый dev-кейс 027 из того проекта. Test F1 без изменений (0.836 против 0.838, в тот же день). Запуски.

2026-09-30 (docs)

• MCP-поток проверен бенчмарком: модель, управляющая реальным сервером через stdio, показала test F1 0.865, precision 0.905, critical recall 1.0 (результаты). Стенд: evals/mcp_client.py, система оценки m.

v1.0.0 (2026-09-30): релиз MCP-сервера

• MCP-сервер v1.0: четыре инструмента Supabase только для чтения, промпт audit и ресурсы каталога. Проверен бенчмарком от начала до конца: модель, управляющая сервером через stdio, показала test F1 0.865 при critical recall 1.0.
• Проверено на хостинговом Supabase: session pooler, роль только для чтения с BYPASSRLS, все 20 запросов.
• Меньше ложных срабатываний:
  • Q1 теперь проверяет API-гранты: RLS выключен при отозванных anon/authenticated не сообщается как открытый.
  • Промпт аудита знает, что функции SECURITY INVOKER имеют только права вызывающего.
  • Обнаружено на реальном проекте; новый dev-кейс 026.
• Зафиксируйте версию: git+https://github.com/Farenhytee/[email protected] в любой команде uvx/pipx. Плагин Claude Code фиксируется автоматически.
• Стандартный аудит теперь по умолчанию в CLI: один промпт плюс проверка anon-пробой, ~$0.0007 и ~15с на аудит. --deep запускает агента с инструментами, который показал тот же результат на нашем стенде при ~5× стоимости.

v0.2.1 (2026-09-30)

• Test F1: агент 0.782 → 0.831, одиночный промпт 0.766 → 0.849. Без падений и таймаутов (результаты).
• Исправлено:
  • Плохой аргумент инструмента больше не завершает аудит; ошибка возвращается модели.
  • Вызовы OpenRouter направляются к самому быстрому провайдеру (медленные вызывали таймауты).
  • Финальный шаг находок агента больше не перечисляет кандидатов, которые он отклонил.

v0.2.0 (2026-09-29)

• Опубликованы результаты тестов: агент F1 0.782, одиночный промпт 0.766, правила 0.559 на слепом, зафиксированном тестовом наборе из 10 кейсов, по 3 запуска каждого (результаты).
• Бенч: 25 размеченных кейсов (15 dev, 10 слепых тестовых).
• Агент:
  • Шаг проверки: пробы как anon для подтверждения эксплуатируемых находок.
  • --fix: выводит SQL исправления для выбранных вами находок. Он никогда не выполняется.
  • Отчёт о стоимости: токены, $ и вызовы инструментов для каждого аудита.
• CI: бесплатный регрессионный шлюз только на правилах.

2026-09-29

• Установка одной командой: плагин Claude Code (skill + MCP-сервер, запрашивает вашу строку подключения) и кнопка Add to Cursor.
• Установка из GitHub: одна команда для MCP-сервера (uvx --from git+… sentinel-mcp) и агента (pipx install "database-sentinel[agent] @ git+…").
• sentinel-mcp --role-sql выводит SQL настройки роли только для чтения.
• Более понятные ошибки: MCP-клиент теперь видит, почему вызов не удался, а CLI выводит однострочную ошибку.

2026-09-28

• Новое: MCP-сервер для Supabase. Четыре инструмента только для чтения, промпт audit и каталог паттернов в качестве ресурсов. Анализ выполняет ваша собственная LLM, так что это бесплатно.
• Новое: lite-агент (sentinel-audit). Конвейер LangGraph, работающий с любой моделью, совместимой с OpenAI: OpenRouter, OpenAI или локальный Ollama.
• Новое: бенчмарк + оценки. 10 размеченных кейсов Supabase с precision/recall/F1, сравнение между базовой линией правил, базовой линией одиночного промпта и агентом.
• Исправлено: шесть запросов аудита Supabase. Q8 (UPDATE без WITH CHECK) никогда ничего не находил, Q16 и Q19 пропускали строки для ролей с минимальными привилегиями, а Q6, Q13 и Q14 имели неверные условия.

Быстрый старт

Claude Code устанавливает skill аудита и MCP-сервер за один раз (требуется uv):

claude plugin marketplace add Farenhytee/database-sentinel
claude plugin install database-sentinel@database-sentinel

Пользователям Supabase: создайте логин только для чтения (шаг 1), затем выполните /plugin configure database-sentinel@database-sentinel в Claude Code. Затем спросите: Audit my database.

Cursor  

Другие MCP-клиенты и полная настройка: руководство по MCP

git clone https://github.com/Farenhytee/database-sentinel.git ~/.claude/skills/database-sentinel

pipx install "database-sentinel[agent] @ git+https://github.com/Farenhytee/database-sentinel"
export SENTINEL_BASE_URL=http://localhost:11434/v1 SENTINEL_MODEL=<model>   # Ollama, or any OpenAI-compatible API + SENTINEL_API_KEY
sentinel-audit --dsn "postgresql://sentinel_auditor:<password>@<host>:5432/postgres" \
  --rest-url https://<ref>.supabase.co --anon-key <anon key> --repo ./my-app

Что он обнаруживает