🛡️ Database Sentinel

데이터베이스 백엔드를 위한 보안 감사. "내 데이터베이스 감사해줘"라고 요청하면 점수가 매겨진 보고서와 정확한 수정 코드를 받을 수 있습니다.

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) 발견을 생성했습니다.
• 벤치마크: 해당 프로젝트의 새 개발 케이스 027. 테스트 F1은 변동 없음 (0.836 vs 0.838, 같은 날). 실행 결과.

2026-09-30 (문서)

• 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 함수는 호출자의 권한만 가진다는 것을 인지합니다.
  • 실제 프로젝트에서 발견됨; 새 개발 케이스 026.
• 버전 고정: 모든 uvx/pipx 명령에서 git+https://github.com/Farenhytee/[email protected]. Claude Code 플러그인은 자동으로 고정됩니다.
• 표준 감사가 이제 CLI 기본값: 하나의 프롬프트와 anon-프로브 검증, 감사당 ~$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 개발, 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는 한 줄 오류를 출력합니다.

2026-09-28

• 신규: MCP 서버 Supabase용. 4개의 읽기 전용 도구, audit 프롬프트 및 패턴 카탈로그를 리소스로 제공. 자체 LLM이 분석을 수행하므로 무료입니다.
• 신규: 라이트 에이전트 (sentinel-audit). 모든 OpenAI 호환 모델과 작동하는 LangGraph 파이프라인: OpenRouter, OpenAI 또는 로컬 Ollama.
• 신규: 벤치마크 + 평가. 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, 또는 모든 OpenAI 호환 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 서버와 에이전트는 아무것도 쓰거나, 삭제하거나, 제거할 수 없습니다.
• 귀하의 행은 절대 읽지 않습니다. 감사 역할은 테이블 데이터에 접근할 수 없습니다. 저장소 스캔은 파일과 줄을 보고하며, 비밀 값은 절대 보고하지 않습니다.
• 쓰기 및 네트워크 프로브는 선택 사항 (Skill 전용). 자세한 내용은 부록 D에 있습니다.

상태

라이선스

MIT. 예외: database_sentinel/agent/, database_sentinel/mcp_server/ 및 database_sentinel/kb/는 AGPL-3.0입니다 (각 디렉토리의 LICENSE 참조).

부록

A. 패턴 하이라이트

Supabase

MongoDB