शैक्षिक उद्देश्यों के लिए नहीं: एक MCP सर्वर जो पेशेवर पेनिट्रेशन टेस्टरों के लिए है, जिसमें STDIO/HTTP/SSE समर्थन, nmap, go/dirbuster, nikto, JtR, hashcat, वर्डलिस्ट निर्माण, और अधिक शामिल है।
Pentest MCP एक TypeScript MCP सर्वर है जो अधिकृत सुरक्षा आकलन के लिए है। यह किसी मानव शोधकर्ता या टूल-उपयोग करने वाले आकलन एजेंट को खोज, सत्यापन, कैप्चर, क्रेडेंशियल जाँच, स्थानीय ऑडिट, साक्ष्य पुनर्प्राप्ति और रिपोर्ट तैयारी के लिए एक सीमित इंटरफ़ेस देता है। प्रत्येक सक्रिय टूल कॉल किसी एंगेजमेंट और एक टिकाऊ रिकॉर्ड से जुड़ा होता है। सर्वर घोषित लक्ष्यों और समय विंडो की जाँच करता है; प्रकाशन से पहले शोधकर्ता निष्कर्षों का सत्यापन करता है।
engagementId चुनता है।allowedToolNames सूची केवल चयनित कॉल की अनुमति देती है। सक्रिय टूल एंगेजमेंट लक्ष्य और समय गेट भी पास करते हैं।listEngagementRecords और getEngagementRecord के साथ recordId मानों और सहसंबद्ध स्कोप निर्णयों की समीक्षा करें। रिकॉर्ड पुनःआरंभ के बाद भी बने रहते हैं। recordResearchActivity के साथ बाहरी शोध आयात करें; आयात MCP टूल उपयोग का स्थान नहीं लेता।getClientReport के साथ Markdown या JSON पुनर्प्राप्त करें।घोषित-लक्ष्य जाँच एक परिचालन सुरक्षा उपाय है, पूर्ण नेटवर्क सीमा नहीं। DNS परिवर्तन, रीडायरेक्ट, Nmap स्क्रिप्ट, Nuclei टेम्पलेट और अन्य तृतीय-पक्ष टूल व्यवहार द्वितीयक ट्रैफ़िक उत्पन्न कर सकते हैं। टूल कॉन्फ़िगरेशन की समीक्षा करें और नेटवर्क नियंत्रणों को एंगेजमेंट के नियमों के अनुरूप रखें।
आकलन चरण एक टूल-उपयोग करने वाला एजेंट सत्र है। runAgentAssessment एक समर्पित खाता प्रोफ़ाइल में स्थानीय Codex या Claude, एक पिन किए गए कंटेनर में Codex, llama.cpp या Ollama जैसे लूपबैक OpenAI-संगत सर्वर, और OpenRouter का समर्थन करता है। CLI वर्कर को एक लॉक किया गया, एकल-एंगेजमेंट Pentest MCP सर्वर मिलता है और वे पूरा कैटलॉग खोजते हैं। गार्डेड API मॉडल को केवल वर्कर कैटलॉग के साथ प्रतिच्छेदित सटीक योजना अनुमति-सूची मिलती है। प्रत्येक अनुरोधित क्रिया हैंडलर शुरू होने से पहले अभी भी वही वर्कर-साइड योजना, लक्ष्य, पैरेंट-स्थिति और समय जाँचों तक पहुँचती है। वैकल्पिक hostileModelProtection डुप्लिकेट-क्रिया, टोकन-लेखांकन और फिनिश-रीज़न सर्किट ब्रेकर जोड़ता है और डिफ़ॉल्ट रूप से false रहता है। एक टिकाऊ स्टार्ट रसीद और बिना टर्मिनल रसीद वाला बाधित रन रीप्ले को अवरुद्ध करता है; reconcileAgentAssessment के लिए आवश्यक है कि एक ऑपरेटर पुष्टि करे कि पिछली प्रक्रिया रुक गई थी, समीक्षक और तर्क दर्ज करे, और जब पिछला वर्कर स्कोप अभी भी उपलब्ध हो तो उसे रद्द करे। लौटाए गए toolCounts, importedRecordIds और importMapRecordId दर्ज की गई क्रियाओं और आयातित साक्ष्य की पहचान करते हैं। बिना किसी सफल आकलन-टूल कॉल वाला रन विफल हो जाता है।
draftAssessmentReport एक बाद का, context-quarantined रिपोर्ट-लेखन चरण है; केवल एक draft यह नहीं दर्शाता कि Pentest MCP ने assessment में सहायता की। OpenAI, Anthropic, OpenRouter, OpenAI-compatible, local Codex, local Claude, container Codex, और configured SSH profiles scanner tools के बिना एक bounded evidence packet से draft तैयार कर सकते हैं। local-agent self-hosted CLI profiles और loopback OpenAI-compatible profiles स्वीकार करता है, जबकि context भेजे जाने से पहले hosted providers को अस्वीकार करता है। guarded model guide llama.cpp और OpenRouter profiles, लागू stop conditions, audit fields, और hostile-model deployment boundaries प्रदान करता है। container assessment guide CLI profile fields, वास्तविक acceptance command, और isolation limits प्रदान करता है। agentic workflow scope, evidence review, Daybreak/Glasswing access, और Faxbot planning को कवर करता है।
Release acceptance scripts/run-real-acceptance.mjs का उपयोग करता है। इसका कोई default target या authorization नहीं है और यह तब तक पास होने से इनकार करता है जब तक कि installed Nmap और ProjectDiscovery HTTPX सफल evidence records न बनाएँ। --profile के साथ, managed agent को Pentest MCP के माध्यम से दोनों को invoke करना होगा। --report-profile के साथ, एक अलग report context को saved draft उत्पन्न करना होगा। Test doubles केवल automated tests में रहते हैं और कभी भी acceptance receipts के रूप में शिप नहीं किए जाते।
Node.js 22.19.0 या नया और उन tools के लिए host binaries आवश्यक हैं जिन्हें आप उपयोग करने का इरादा रखते हैं। Docker image में सूचीबद्ध tools शामिल हैं; native installations को उन्हें PATH में प्रदान करना होगा।
npm install -g pentest-mcp
pentest-mcp
Stdio स्थानीय MCP क्लाइंट्स के लिए डिफ़ॉल्ट है। pentest-mcp inspector इस सर्वर के विरुद्ध stdio के माध्यम से बंडल किए गए MCP Inspector को शुरू करता है; 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"
}
]
}
}
अनुमत लक्ष्य सटीक होस्ट, CIDR, वाइल्डकार्ड सबडोमेन, और HTTP(S) URL प्रीफ़िक्स स्वीकार करते हैं। बहिष्करण प्राथमिकता लेते हैं। सभी टाइमस्टैम्प के लिए स्पष्ट टाइमज़ोन आवश्यक है। getEngagement और listEngagements संग्रहीत पंजीकरणों का निरीक्षण करते हैं। closeEngagement बाद के निष्पादन को रद्द करता है, उसी सर्वर प्रक्रिया में चल रहे प्रबंधित आकलनों को निरस्त करता है, और एक अलग प्रबंधित रनर को तब रुकने का कारण बनता है जब वह पैरेंट रजिस्ट्री क्लोज़र को देखता है।
सक्रिय टूल के लिए वही engagementId उपयोग करें। डिफ़ॉल्ट गैर-रूट कंटेनर TCP कनेक्ट स्कैन का समर्थन करता है; SYN और OS डिटेक्शन के लिए अतिरिक्त विशेषाधिकार आवश्यक हैं जो डिफ़ॉल्ट रूप से प्रदान नहीं किए जाते हैं।
{
"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
}
}