خادم MCP يتيح لمساعدي الذكاء الاصطناعي تشغيل تثبيت Sn1per مستضاف ذاتيًا، وإجراء فحوصات محددة النطاق ومُدقّقة، وإرجاع النتائج والمنافذ والنطاقات الفرعية والتقنيات كبيانات منظمة.
شغّل Sn1per المستضاف ذاتيًا من مساعد الذكاء الاصطناعي الخاص بك: مقيّد النطاق، ومُدقّق، للاختبار المصرّح به.
للاختبار الأمني المصرّح به فقط. استخدم خادم Sn1per MCP فقط ضد الأنظمة التي تملكها أو يُسمح لك صراحةً، كتابيًا، باختبارها، وضمن نطاق ذلك الإذن.
الحالة: إصدار تجريبي (0.9.x). تتبع أسماء الأدوات والمعاملات وحقول المخرجات وعد التوافق لإصدارات 0.x.
يربط خادم Sn1per MCP مساعد الذكاء الاصطناعي الذي تستخدمه بالفعل بتثبيت Sn1per على مضيف Linux الخاص بك. يعمل محليًا عبر stdio بجانب Sn1per، ويرفض طلبات الفحص للأهداف خارج النطاق الذي تضبطه (انظر الحدود)، ويسجّل كل طلب فحص أو إلغاء أو حذف أو تصدير ينفّذه في سجل تدقيق محلي، ويعيد نتائج Sn1per والمنافذ المفتوحة والنطاقات الفرعية والتقنيات كبيانات منظمة مع تنقيح الأسرار افتراضيًا. يدعم Sn1per Community Edition 9.x ومحرك 11.x المستخدم في SE وProfessional وEnterprise؛ وتُدرج مصفوفة الإصدارات ما تم التحقق منه. وهو مجاني ومفتوح المصدر بموجب ترخيص Apache-2.0، ومخصص للاختبار الأمني المصرّح به فقط.
يعمل الخادم بجانب Sn1per على مضيفك: تبقى المقتنيات هناك، ولا تغادر نتائج الأدوات المضيف إلا عبر عميل MCP الخاص بك وخدمة النموذج التي يستخدمها. اقرأ معالجة البيانات والخصوصية لمعرفة ما يغادر المضيف.
Sn1per يقوم بالفحص. ويتيح خادم Sn1per MCP لمساعد الذكاء الاصطناعي الذي تستخدمه بالفعل تشغيله. تعرض خوادم MCP العامة لتشغيل الأدوات أوامر فردية. أما خادم Sn1per MCP فيشغّل أوضاع الفحص المنسّقة في Sn1per ويعيد نتائجه المنظمة، مع فرض النطاق وسجل تدقيق.
استبدل <user> بالمستخدم الذي يشغّل عميل MCP الخاص بك. ملف env هو التكوين المعتمد، لذا يرى --check بالضبط ما سيشغّله العميل.
ثبّت pipx، ثم ثبّت الخادم بذلك المستخدم (لا تشغّل pipx أبدًا باستخدام sudo):
sudo apt install pipx
pipx ensurepath
# open a new shell, then:
pipx install sn1per-mcp==0.9.0
أنشئ ملف البيئة /home/<user>/.config/sn1per-mcp/env بصلاحيات 0600:
mkdir -p /home/<user>/.config/sn1per-mcp
install -m 0600 /dev/null /home/<user>/.config/sn1per-mcp/env
ضع هذا السطر فيه، ثم استبدل العنصر النائب بالأهداف المصرح لك باختبارها. يتم رفض العنصر النائب نفسه (scope_invalid)، لذا لن يتم فحص أي شيء حتى تقوم بذلك.
SNIPER_MCP_SCOPE=<authorized-targets>
تحقق من الإعدادات. يتضمن المخرجات المسار الحقيقي لـ Sn1per CLI الذي يجب أن تسميه قاعدة sudo:
/home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env --check
أضف ملف sudoers drop-in مع مسار realpath هذا (/usr/share/sniper/sniper في التثبيت القياسي). تخطَّ هذه الخطوة إذا كان العميل يعمل بصلاحيات root. الخطوات الكاملة: docs/install.md.
sudo visudo -f /etc/sudoers.d/sn1per-mcp
<user> ALL=(root) NOPASSWD: /usr/share/sniper/sniper
سجّل الخادم مع Claude Code (عملاء آخرون: docs/clients.md):
claude mcp add sn1per -s user -- /home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env
ابدأ جلسة عميل جديدة واسأل: "Run sniper_status".
يتم إدراج العملاء الذين اجتازوا اختبارات عميل 0.9.0 (2026-10-12) فقط. مسارات التكوين وإعدادات الموافقة والملاحظات الخاصة بكل عميل موجودة في docs/clients.md.
| العميل | الحالة | أدوات الحذف والتصدير (تحتاج MCP elicitation) |
|---|---|---|
| Claude Code (2.1.284) | تم التحقق منه | نعم، في الجلسات التفاعلية؛ claude -p بدون مضيف SDK يلغي التأكيد، لذا لا يتم حذف أو تصدير أي شيء |
| Codex CLI (0.125.0) | تم التحقق منه في codex exec فقط | لا في codex exec، الذي يرفض التأكيد؛ واجهة Codex التفاعلية لم يتم اختبارها بعد |
| عملاء الويب والجوال والموصلات البعيدة | غير مدعومة في 0.9.0 (stdio فقط) | لا ينطبق |
Claude Code: الأمر أحادي السطر في البدء السريع (الخطوة 5). Codex CLI: إدخال config.toml، وإعداد الموافقة الذي يحتاجه export_workspace هناك، موجودان في docs/clients.md. العملاء الآخرون الذين يشغلون خوادم stdio المحلية لم يتم اختبارهم بعد مع 0.9.0.
هل Sn1per على جهاز آخر، أم أن عميلك على macOS أو Windows؟ راجع docs/remote.md لوصفة SSH (تم التحقق منها مع عميل Linux OpenSSH؛ عملاء Windows وmacOS موثقون، غير متحقق منهم)، وWSL2 (موثق، غير متحقق منه) ووصفات Docker (موثقة، غير متحقق منها).
يكتشف الخادم الإصدار والمحرك من Sn1per CLI على المضيف. "تم التحقق منه" يعني أنه تم اختباره بواسطة تشغيل التحقق 0.9.0 في 2026-10-12؛ "متوقع" يعني عدم وجود عائق معروف، لكن لم يتم اختباره. النتائج لكل أداة، وأوضاع الفحص التي تم تشغيلها والإصلاحات التي تم إجراؤها بعد التشغيل موجودة في docs/editions.md، مع جداول الأوضاع والملاحظات الخاصة بكل إصدار.
| الإصدار | لهجة المحرك | الحالة |
|---|---|---|
Sn1per Community Edition 9.2 (مستودع master عند a5450bc) | 9.x | تم التحقق منه 2026-10-12، مع تشغيل الخادم كـ root |
| إصدارات Sn1per Community Edition 9.x اللاحقة | 9.x | متوقع |
| Sn1per SE 11.0 و11.1 | 11.x | تم التحقق منه 2026-10-12 (11.0 كـ root وكـ مستخدم عادي عبر sudo، 11.1 كـ root) |
| Sn1per Enterprise، إصدار تطوير 11.3 | 11.x | تم التحقق منه 2026-10-12، كمستخدم عادي عبر sudo |
| إصدارات 11.x الأخرى، بما في ذلك 11.2 | 11.x | متوقع |
| Sn1per Professional 2026 | 11.x | يستخدم نفس محرك 11.x مثل SE وEnterprise؛ لم يتم تشغيله بعد على تثبيت Professional |
| Sn1per Community Edition أقل من 9.2 | - | غير مدعوم |
المنصات: Linux فقط. تم التحقق منه على Kali Rolling (amd64). Ubuntu 24.04: تم التحقق منه للتثبيت وجلسة MCP (لم يتم تشغيل أي فحص على Ubuntu). Debian 12 و13 وParrot: متوقع. Ubuntu 22.04 وKali 2022.x: متوقع فقط مع Python مُدار بواسطة uv أو Python 3.11 أو أحدث مثبت بشكل منفصل؛ يتم رفض Python 3.10 النظامي الخاص بهما. BlackArch: متوقع؛ يحتاج إلى رابط رمزي sniper على PATH. arm64: متوقع. macOS وWindows غير مدعومين كمضيف للخادم؛ استخدمهما كمضيف للعميل عبر SSH (docs/remote.md).
المعاملات الكاملة ونتائج الأمثلة ورموز الأخطاء: docs/tools.md.