ليس للأغراض التعليمية: خادم MCP لمختبر الاختراق المحترفين يدعم STDIO/HTTP/SSE، nmap، go/dirbuster، nikto، JtR، hashcat، بناء قوائم الكلمات، والمزيد.
Pentest MCP هو خادم MCP مكتوب بـ TypeScript لتقييمات الأمن المصرّح بها. يمنح الباحث البشري أو وكيل التقييم الذي يستخدم الأدوات واجهة واحدة محددة النطاق للاستكشاف والتحقق والالتقاط وفحص بيانات الاعتماد والتدقيق المحلي واسترجاع الأدلة وإعداد التقارير. كل استدعاء أداة نشط مرتبط بمهمة وسجل دائم. يتحقق الخادم من الأهداف المعلنة والنافذة الزمنية؛ ويتحقق الباحث من النتائج قبل النشر.
engagementId ثابتًا.allowedToolNames الدقيقة الخاصة بالخطة باستدعاءات محددة فقط. تمر الأدوات النشطة أيضًا عبر بوابة هدف المهمة والوقت.recordId وقرارات النطاق المترابطة باستخدام listEngagementRecords وgetEngagementRecord. تبقى السجلات محفوظة عبر عمليات إعادة التشغيل. استورد البحث الخارجي باستخدام recordResearchActivity؛ ولا يحل الاستيراد محل استخدام أدوات MCP.getClientReport.فحص الهدف المعلن هو ضمانة تشغيلية، وليس حدًا شبكيًا كاملًا. يمكن لتغييرات DNS وعمليات إعادة التوجيه ونصوص Nmap وقوالب Nuclei وسلوك الأدوات الخارجية الأخرى أن تُنشئ حركة مرور ثانوية. راجع إعدادات الأدوات وحافظ على توافق ضوابط الشبكة مع قواعد المهمة.
مرحلة التقييم هي جلسة وكيل تستخدم الأدوات. يدعم runAgentAssessment كلاً من Codex المحلي أو Claude في ملف تعريف حساب مخصص، وCodex في حاوية مثبّتة، وخادم OpenAI متوافق مع loopback مثل llama.cpp أو Ollama، وOpenRouter. يتلقى عمال CLI خادم Pentest MCP مقفلًا لمهمة واحدة ويكتشفون الكتالوج الكامل. تتلقى نماذج API المحمية فقط قائمة السماح الدقيقة الخاصة بالخطة متقاطعة مع كتالوج العامل. لا يزال كل إجراء مطلوب يصل إلى نفس فحوصات الخطة والهدف وحالة الأصل والوقت على جانب العامل قبل بدء المعالج. يضيف hostileModelProtection الاختياري قواطع دائرة للإجراءات المكررة ومحاسبة الرموز وأسباب الإنهاء، وقيمته الافتراضية false. تحظر أي عملية تشغيل متقطعة لها إيصال بدء دائم ولا إيصال إنهاء إعادة التشغيل؛ ويتطلب reconcileAgentAssessment من المشغّل تأكيد توقف العملية السابقة، ويسجل المراجع والمبرر، ويُلغي نطاق العامل السابق عندما يكون لا يزال متاحًا. تحدد toolCounts وimportedRecordIds وimportMapRecordId المُعادة الإجراءات المسجلة والأدلة المستوردة. تفشل أي عملية تشغيل لا تتضمن استدعاء ناجحًا لأداة تقييم.
draftAssessmentReport هي خطوة لاحقة لكتابة التقرير معزولة عن السياق؛ فمجرد وجود مسودة لا يُظهر أن Pentest MCP ساعد في التقييم. يمكن لـ OpenAI وAnthropic وOpenRouter وOpenAI-compatible وCodex المحلي وClaude المحلي وCodex في الحاوية وملفات تعريف SSH المُهيأة أن تكتب مسودة من حزمة أدلة محدودة دون أدوات فحص. يقبل local-agent ملفات تعريف CLI المستضافة ذاتيًا وملفات تعريف OpenAI-compatible عبر loopback مع رفض المزوّدين المستضافين قبل إرسال السياق. يقدّم دليل النماذج المحمية ملفات تعريف llama.cpp وOpenRouter، وشروط التوقف المفروضة، وحقول التدقيق، وحدود نشر النماذج العدائية. يقدّم دليل تقييم الحاويات حقول ملف تعريف CLI، وأمر القبول الفعلي، وحدود العزل. يغطي سير العمل الوكيلي النطاق، ومراجعة الأدلة، والوصول إلى Daybreak/Glasswing، وتخطيط Faxbot.
يستخدم قبول الإصدار scripts/run-real-acceptance.mjs. لا يحتوي على هدف افتراضي أو تفويض ويرفض النجاح ما لم تُنشئ أداتا Nmap وProjectDiscovery HTTPX المثبّتتان سجلات أدلة ناجحة. مع --profile، يجب على الوكيل المُدار استدعاء كلتيهما عبر Pentest MCP. مع --report-profile، يجب أن ينتج سياق تقرير منفصل المسودة المحفوظة. تبقى البدائل الاختبارية (test doubles) في الاختبارات الآلية فقط ولا تُشحن أبدًا كإيصالات قبول.
يتطلب Node.js 22.19.0 أو أحدث والثنائيات المضيفة للأدوات التي تنوي استخدامها. تتضمن صورة Docker الأدوات المدرجة؛ ويجب أن توفّرها التثبيتات الأصلية في PATH.
npm install -g pentest-mcp
pentest-mcp
Stdio هو الوضع الافتراضي لعملاء MCP المحليين. يشغّل pentest-mcp inspector أداة MCP Inspector المضمّنة مقابل هذا الخادم عبر stdio؛ ويمكن تمرير أعلام Inspector، على سبيل المثال pentest-mcp inspector --help.
اضبط PENTEST_DATA_DIR لاختيار دليل الأدلة المحلي. وإلا يستخدم الخادم $XDG_DATA_HOME/pentest-mcp عند تعيين هذا المتغير، أو ~/.pentest-mcp. تُخزَّن ملفات الأدلة والتقارير بأذونات دليل وملفات خاصة. تعامل مع المخرجات الخام والتجزئات وحركة المرور الملتقطة والتقارير كبيانات حساسة للعميل؛ واضبط الوصول والاحتفاظ والنسخ الاحتياطي وفقًا لذلك.
استدعِ createEngagement قبل الفحص. استخدم التواريخ والأهداف والمراجع من التفويض الموقّع الفعلي؛ القيم أدناه توضيحية فقط.
{
"tool": "createEngagement",
"arguments": {
"engagementId": "client-2026-10",
"authorizationReference": "Signed SoW section 4, approved 2026-10-24",
"notBefore": "2026-10-25T09:00:00-06:00",
"expiresAt": "2026-10-26T18:00:00-06:00",
"allowedTargets": ["app.example.com", "192.0.2.0/28"],
"excludedTargets": ["192.0.2.7"],
"testingWindows": [
{
"start": "2026-10-25T09:00:00-06:00",
"end": "2026-10-25T17:00:00-06:00"
}
]
}
}
تقبل الأهداف المسموح بها مضيفين محددين تمامًا، وCIDRs، ونطاقات فرعية بعلامة بدل، وبادئات عناوين URL من نوع HTTP(S). وللاستثناءات الأولوية. تحتاج جميع الطوابع الزمنية إلى منطقة زمنية صريحة. يفحص getEngagement وlistEngagements التسجيلات المخزنة. ويُلغي closeEngagement التنفيذ اللاحق، ويوقف التقييمات المُدارة التي تعمل في عملية الخادم نفسها، ويؤدي إلى توقف مشغّل مُدار منفصل عند ملاحظته إغلاق سجل الأصل.
استخدم نفس engagementId للأدوات النشطة. تدعم الحاوية الافتراضية غير الجذرية فحص اتصال TCP؛ بينما يحتاج اكتشاف SYN ونظام التشغيل إلى صلاحيات إضافية غير ممنوحة افتراضيًا.
{
"tool": "nmapScan",
"arguments": {
"engagementId": "client-2026-10",
"target": "app.example.com",
"scanTechnique": "Connect",
"serviceVersionDetection": true
}
}
تتضمن استجابة الأداة الناجحة recordId للأدلة المخزّنة الخاصة بها. استرجع فقط السجلات التي تحتاجها:
{
"tool": "listEngagementRecords",
"arguments": {
"engagementId": "client-2026-10",
"limit": 50
}
}
تُرجع listEngagementRecords ملخصات وتقبل limit وoffset للتنقل عبر السجلات الأقدم. تأخذ getEngagementRecord كلاً من engagementId وrecordId وتُرجع الأدلة المخزنة عند السماح بذلك. تُرجع أدوات بيانات الاعتماد أعداداً وملخصات المخرجات. تحتفظ سجلات Gobuster/Nikto الجديدة غير المصادَق عليها بمخرجات الماسح والنتائج الخاصة للقراءات المقيّدة بالمالك؛ تبقى سجلات الماسح الأقدم محجوبة. يُحتفظ بـ Nmap XML ومخرجات ffuf/Nuclei الآلية المحدودة إلى جانب الملخصات. تكون outcome للسجل إما succeeded أو failed أو cancelled، مع وقت بدء ومدة عند تتبعها؛ تُنشئ إخفاقات العمليات الفرعية سجل تدقيق بدلاً من نتيجة مسح ناجحة. يبدأ رفض النطاق في الفحص المسبق دون تنفيذ أي أمر. بالنسبة لـ HTTP المصادَق عليه، يكون الوصول إلى engagement والأدلة مقيّداً بمالك الرمز المُتحقَّق منه؛ بيانات stdio محلية لتثبيت الخادم.