🛡️ Database Sentinel

データベースバックエンドのセキュリティ監査。 「audit my database」と尋ねるだけで、スコア付きレポートと正確な修正コードが得られます。

Claude Skill（Supabase、MongoDB）、任意のAIクライアント向けの読み取り専用MCPサーバー、または独自のモデルを使用するCLIエージェント（両方ともSupabase）として動作します。

→ MCPサーバーのセットアップと使用ガイド

→ 自分で実行したくない場合は？ Locksoup がホスト版です：スケジュールされた再チェックとアラートを備えたSupabaseセキュリティ監査。

変更履歴

2026-10-01 (v1.0.1)

• 修正: WITH CHECKのないUPDATEポリシーが、ユーザーによる行の所有権の再割り当てを許可していると報告されなくなりました（PostgresはUSINGをチェックとして再利用します）。Q8のラベルとエージェントプロンプトはそう述べていたため、実際のプロジェクトで誤ったmass-assignmentの検出結果が生成されていました。
• ベンチマーク: そのプロジェクトからの新しいdevケース027。テストF1は変わらず（0.836 vs 0.838、同日）。実行結果。

2026-09-30 (docs)

• MCPフローのベンチマーク: 実際のサーバーをstdio経由で駆動するモデルが、テストF1 0.865、適合率0.905、クリティカル再現率1.0を記録しました（結果）。ハーネス: evals/mcp_client.py、評価システム m。

v1.0.0 (2026-09-30): MCPサーバーリリース

• MCPサーバー v1.0: 4つの読み取り専用Supabaseツール、auditプロンプト、カタログリソース。エンドツーエンドでベンチマーク済み: サーバーをstdio経由で駆動するモデルがテストF1 0.865、クリティカル再現率1.0を記録。
• ホスト型Supabaseで検証済み: セッションプーラー、BYPASSRLSを持つ読み取り専用ロール、全20クエリ。
• 誤検知の削減:
  • Q1がAPIグラントをチェックするようになりました: RLSがオフでもanon/authenticatedが取り消されていれば、公開されているとは報告されません。
  • 監査プロンプトは、SECURITY INVOKER関数が呼び出し元の権限のみを持つことを認識しています。
  • 実際のプロジェクトで発見されました。新しいdevケース026。
• バージョンの固定: 任意のuvx/pipxコマンドでgit+https://github.com/Farenhytee/[email protected]。Claude Codeプラグインは自動的に固定されます。
• 標準監査がCLIのデフォルトに: 1つのプロンプトとanon-probe検証で、監査あたり約$0.0007、約15秒。--deepはツールを使用するエージェントを実行し、ベンチでは同じスコアを約5倍のコストで記録しました。

v0.2.1 (2026-09-30)

• テストF1: エージェント 0.782 → 0.831、シングルプロンプト 0.766 → 0.849。クラッシュやタイムアウトなし（結果）。
• 修正:
  • 不正なツール引数で監査が終了しなくなりました。エラーはモデルに返されます。
  • OpenRouter呼び出しは最速のプロバイダーにルーティングされます（遅いプロバイダーがタイムアウトを引き起こしていました）。
  • エージェントの最終的な検出ステップで、却下した候補がリストされなくなりました。

v0.2.0 (2026-09-29)

• テスト結果の公開: ブラインドで固定された10ケースのテスト分割で、エージェントF1 0.782、シングルプロンプト 0.766、ルール 0.559、各3回実行（結果）。
• ベンチ: 25のラベル付きケース（15 dev、10ブラインドテスト）。
• エージェント:
  • 検証ステップ: anonとしてプローブし、悪用可能な検出結果を確認します。
  • --fix: 選択した検出結果の修正SQLを出力します。実行されることはありません。
  • コストレポート: 各監査のトークン、$、ツール呼び出し。
• CI: 無料のルールのみの回帰ゲート。

2026-09-29

• ワンコマンドインストール: Claude Codeプラグイン（スキル + MCPサーバー、接続文字列を要求）とAdd to Cursorボタン。
• GitHubからのインストール: MCPサーバー（uvx --from git+… sentinel-mcp）とエージェント（pipx install "database-sentinel[agent] @ git+…"）のワンコマンド。
• sentinel-mcp --role-sqlが読み取り専用ロールのセットアップSQLを出力します。
• より明確なエラー: MCPクライアントが呼び出し失敗の理由を確認でき、CLIは1行のエラーを出力します。

2026-09-28

• 新規: MCPサーバー（Supabase向け）。4つの読み取り専用ツール、auditプロンプト、パターンカタログをリソースとして。独自のLLMが分析を行うため、無料です。
• 新規: liteエージェント（sentinel-audit）。任意のOpenAI互換モデル（OpenRouter、OpenAI、ローカルOllama）で動作するLangGraphパイプライン。
• 新規: ベンチマーク + 評価。 10のラベル付きSupabaseケースで、ルールベースライン、シングルプロンプトベースライン、エージェント間で適合率/再現率/F1を比較。
• 修正: 6つのSupabase監査クエリ。Q8（WITH CHECKなしのUPDATE）は何もマッチせず、Q16とQ19は最小権限ロールの行を見逃し、Q6、Q13、Q14は条件が誤っていました。

クイックスタート

Claude Codeは監査スキルとMCPサーバーを一度にインストールします（uvが必要）:

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

Supabaseユーザー: 読み取り専用ログインを作成し（ステップ1）、Claude Codeで/plugin configure database-sentinel@database-sentinelを実行します。その後、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

検出するもの

完全な表は付録Aにあります。

安全性

• デフォルトで読み取り専用。 システムカタログのみが読み取られます。MCPサーバーとエージェントは何も書き込み、削除、ドロップできません。
• あなたの行は決して読み取られません。 監査ロールはテーブルデータにアクセスできません。リポジトリスキャンはファイルと行を報告し、シークレットの値は決して報告しません。
• 書き込みおよびネットワークプローブはオプトインです（スキルのみ）。詳細は付録Dにあります。

ステータス

ライセンス

MIT。例外: database_sentinel/agent/、database_sentinel/mcp_server/、database_sentinel/kb/はAGPL-3.0です（それぞれのLICENSEを参照）。

付録

A. パターンハイライト

Supabase

MongoDB