🛡️ Database Sentinel

Audits de sécurité pour votre backend de base de données. Demandez « audite ma base de données » et obtenez un rapport noté avec le code de correction exact.

Fonctionne comme Claude Skill (Supabase, MongoDB), comme serveur MCP en lecture seule pour tout client IA, ou comme agent CLI qui utilise votre propre modèle (les deux pour Supabase).

→ Configuration et guide d'utilisation du serveur MCP

→ Vous ne voulez pas l'exécuter vous-même ? Locksoup est la version hébergée : un audit de sécurité Supabase avec revérifications planifiées et alertes.

Journal des modifications

2026-10-01 (v1.0.1)

• Corrigé : une politique UPDATE sans WITH CHECK n'est plus signalée comme permettant aux utilisateurs de réattribuer la propriété des lignes (Postgres réutilise USING comme vérification). Le libellé de Q8 et le prompt de l'agent indiquaient le contraire, ce qui produisait de faux constats d'assignation massive sur de vrais projets.
• Benchmark : nouveau cas de dev 027 issu de ce projet. F1 de test inchangé (0,836 vs 0,838, même jour). Exécutions.

2026-09-30 (docs)

• Flux MCP benchmarké : un modèle pilotant le vrai serveur via stdio a obtenu un F1 de test de 0,865, une précision de 0,905, un rappel critique de 1,0 (résultats). Harnais : evals/mcp_client.py, système d'évaluation m.

v1.0.0 (2026-09-30) : publication du serveur MCP

• Serveur MCP v1.0 : quatre outils Supabase en lecture seule, un prompt audit et les ressources du catalogue. Benchmarké de bout en bout : un modèle pilotant le serveur via stdio a obtenu un F1 de test de 0,865, avec un rappel critique de 1,0.
• Vérifié sur Supabase hébergé : session pooler, rôle en lecture seule avec BYPASSRLS, les 20 requêtes.
• Moins de fausses alertes :
  • Q1 vérifie désormais les autorisations API : RLS désactivé avec anon/authenticated révoqués n'est pas signalé comme exposé.
  • Le prompt d'audit sait que les fonctions SECURITY INVOKER n'ont que les droits de l'appelant.
  • Découvert sur un vrai projet ; nouveau cas de dev 026.
• Épingler une version : git+https://github.com/Farenhytee/[email protected] dans toute commande uvx/pipx. Le plugin Claude Code est épinglé automatiquement.
• L'audit standard est désormais la valeur par défaut du CLI : un prompt plus une vérification par sonde anon, ~0,0007 $ et ~15 s par audit. --deep exécute l'agent utilisant des outils, qui a obtenu le même score sur notre bench pour ~5× le coût.

v0.2.1 (2026-09-30)

• F1 de test : agent 0,782 → 0,831, prompt unique 0,766 → 0,849. Aucun plantage ni timeout (résultats).
• Corrigé :
  • Un mauvais argument d'outil ne met plus fin à l'audit ; l'erreur est renvoyée au modèle.
  • Les appels OpenRouter sont routés vers le fournisseur le plus rapide (les lents provoquaient des timeouts).
  • L'étape finale des constats de l'agent ne liste plus les candidats qu'il avait écartés.

v0.2.0 (2026-09-29)

• Résultats de test publiés : agent F1 0,782, prompt unique 0,766, règles 0,559 sur un split de test aveugle et verrouillé de 10 cas, 3 exécutions chacun (résultats).
• Bench : 25 cas étiquetés (15 dev, 10 test aveugle).
• Agent :
  • Étape de vérification : sonde en tant qu'anon pour confirmer les constats exploitables.
  • --fix : affiche le SQL de correction pour les constats que vous choisissez. Il n'est jamais exécuté.
  • Rapport de coût : tokens, $ et appels d'outils pour chaque audit.
• CI : porte de régression gratuite basée uniquement sur les règles.

2026-09-29

• Installation en une commande : plugin Claude Code (skill + serveur MCP, demande votre chaîne de connexion) et un bouton Add to Cursor.
• Installation depuis GitHub : une commande pour le serveur MCP (uvx --from git+… sentinel-mcp) et l'agent (pipx install "database-sentinel[agent] @ git+…").
• sentinel-mcp --role-sql affiche le SQL de configuration du rôle en lecture seule.
• Erreurs plus claires : le client MCP voit désormais pourquoi un appel a échoué, et le CLI affiche une erreur sur une seule ligne.

2026-09-28

• Nouveau : serveur MCP pour Supabase. Quatre outils en lecture seule, un prompt audit et le catalogue de patterns comme ressources. Votre propre LLM fait l'analyse, c'est donc gratuit.
• Nouveau : agent lite (sentinel-audit). Un pipeline LangGraph qui fonctionne avec tout modèle compatible OpenAI : OpenRouter, OpenAI ou Ollama local.
• Nouveau : benchmark + evals. 10 cas Supabase étiquetés, avec précision/rappel/F1 comparés entre une baseline de règles, une baseline à prompt unique et l'agent.
• Corrigé : six requêtes d'audit Supabase. Q8 (UPDATE sans WITH CHECK) ne correspondait jamais à rien, Q16 et Q19 manquaient des lignes pour les rôles à moindre privilège, et Q6, Q13 et Q14 avaient des conditions erronées.

Démarrage rapide

Claude Code installe la skill d'audit et le serveur MCP en une seule fois (nécessite uv) :

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

Utilisateurs Supabase : créez le login en lecture seule (étape 1), puis exécutez /plugin configure database-sentinel@database-sentinel dans Claude Code. Demandez ensuite : Audit my database.

Cursor  

Autres clients MCP, et configuration complète : guide 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