🛡️ Database Sentinel

تدقيق أمني لواجهة قاعدة بياناتك الخلفية. اطلب "audit my database" واحصل على تقرير مُقيَّم مع كود إصلاح دقيق.

يعمل كـ Claude Skill (Supabase، MongoDB)، أو خادم MCP للقراءة فقط لأي عميل ذكاء اصطناعي، أو وكيل CLI يستخدم نموذجك الخاص (كلاهما Supabase).

→ إعداد خادم MCP ودليل الاستخدام

→ لا تريد تشغيله بنفسك؟ Locksoup هو النسخة المستضافة: تدقيق أمني لـ Supabase مع إعادة فحص مجدولة وتنبيهات.

سجل التغييرات

2026-10-01 (v1.0.1)

• إصلاح: لم يعد يتم الإبلاغ عن سياسة UPDATE بدون WITH CHECK على أنها تسمح للمستخدمين بإعادة تعيين ملكية الصفوف (Postgres يعيد استخدام USING كفحص). كان تسمية Q8 ومطالبة الوكيل تقولان خلاف ذلك، مما أنتج نتائج إسناد جماعي خاطئة على مشاريع حقيقية.
• المعيار: حالة تطوير جديدة 027 من ذلك المشروع. اختبار F1 دون تغيير (0.836 مقابل 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: أربع أدوات Supabase للقراءة فقط، ومطالبة audit وموارد الكتالوج. تم قياسه من البداية إلى النهاية: نموذج يقود الخادم عبر stdio سجّل اختبار F1 0.865، مع استدعاء حرج 1.0.
• تم التحقق على Supabase المستضاف: session pooler، دور للقراءة فقط مع BYPASSRLS، جميع الاستعلامات العشرين.
• إنذارات كاذبة أقل:
  • Q1 يتحقق الآن من منح API: إيقاف RLS مع إلغاء anon/authenticated لا يتم الإبلاغ عنه كمكشوف.
  • مطالبة التدقيق تعرف أن دوال SECURITY INVOKER لديها فقط حقوق المستدعي.
  • تم اكتشافه على مشروع حقيقي؛ حالة تطوير جديدة 026.
• تثبيت إصدار: git+https://github.com/Farenhytee/[email protected] في أي أمر uvx/pipx. إضافة Claude Code مثبتة تلقائيًا.
• التدقيق القياسي هو الآن الافتراضي في CLI: مطالبة واحدة بالإضافة إلى التحقق من 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)

• نتائج اختبار منشورة: الوكيل F1 0.782، مطالبة واحدة 0.766، القواعد 0.559 على تقسيم اختبار أعمى ومقفل من 10 حالات، 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. أربع أدوات للقراءة فقط، ومطالبة audit وكتالوج الأنماط كموارد. نموذجك اللغوي الخاص يقوم بالتحليل، لذا فهو مجاني.
• جديد: وكيل lite (sentinel-audit). خط أنابيب LangGraph يعمل مع أي نموذج متوافق مع OpenAI: OpenRouter، OpenAI، أو Ollama المحلي.
• جديد: معيار + تقييمات. 10 حالات Supabase مُصنَّفة، مع مقارنة الدقة/الاستدعاء/F1 عبر خط أساس للقواعد، وخط أساس لمطالبة واحدة، والوكيل.
• إصلاح: ستة استعلامات تدقيق Supabase. Q8 (UPDATE بدون WITH CHECK) لم يطابق أي شيء أبدًا، 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)، ثم شغّل /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

ما يكتشفه

الجداول الكاملة في الملحق أ.

الأمان

• للقراءة فقط افتراضيًا. يتم قراءة كتالوجات النظام فقط. لا يمكن لخادم MCP والوكيل الكتابة أو الإسقاط أو الحذف.
• لا يتم قراءة صفوفك أبدًا. دور التدقيق ليس لديه وصول إلى بيانات الجدول. فحوصات المستودع تبلغ عن الملف والسطر، وليس قيم الأسرار أبدًا.
• فحوصات الكتابة والشبكة اختيارية (المهارة فقط). التفاصيل في الملحق د.

الحالة