교육 목적이 아닙니다: STDIO/HTTP/SSE를 지원하는 전문 침투 테스터를 위한 MCP 서버로, nmap, go/dirbuster, nikto, JtR, hashcat, 워드리스트 구축 등이 포함되어 있습니다.
Pentest MCP는 승인된 보안 평가를 위한 TypeScript MCP 서버입니다. 사람 연구자 또는 도구를 사용하는 평가 에이전트에게 탐색, 검증, 캡처, 자격 증명 확인, 로컬 감사, 증거 검색, 보고서 준비를 위한 하나의 범위 지정 인터페이스를 제공합니다. 각 활성 도구 호출은 하나의 engagement와 영구 기록에 연결됩니다. 서버는 선언된 대상과 시간 범위를 확인하며, 연구자는 게시 전에 발견 사항을 검증합니다.
engagementId를 선택합니다.allowedToolNames 목록은 선택된 호출만 허용합니다. 활성 도구는 또한 engagement 대상 및 시간 게이트를 통과해야 합니다.listEngagementRecords와 getEngagementRecord로 recordId 값과 상호 연관된 범위 결정을 검토합니다. 기록은 재시작 후에도 유지됩니다. recordResearchActivity로 외부 연구를 가져올 수 있으며, 이 가져오기는 MCP 도구 사용을 대체하지 않습니다.getClientReport로 Markdown 또는 JSON을 검색할 수 있습니다.선언된 대상 확인은 운영상의 안전장치이며 완전한 네트워크 경계가 아닙니다. DNS 변경, 리디렉션, Nmap 스크립트, Nuclei 템플릿 및 기타 타사 도구 동작은 2차 트래픽을 생성할 수 있습니다. 도구 구성을 검토하고 네트워크 제어가 engagement의 규칙과 일치하도록 유지하십시오.
평가 단계는 도구를 사용하는 에이전트 세션입니다. runAgentAssessment는 전용 계정 프로필의 로컬 Codex 또는 Claude, 고정된 컨테이너의 Codex, llama.cpp 또는 Ollama와 같은 루프백 OpenAI 호환 서버, 그리고 OpenRouter를 지원합니다. CLI 워커는 잠긴 단일 engagement Pentest MCP 서버를 받고 전체 카탈로그를 탐색합니다. 보호된 API 모델은 워커 카탈로그와 교집합을 이룬 정확한 계획 허용 목록만 받습니다. 요청된 모든 작업은 핸들러가 시작되기 전에 동일한 워커 측 계획, 대상, 상위 상태 및 시간 검사를 거칩니다. 선택적 hostileModelProtection은 중복 작업, 토큰 회계, 종료 사유 회로 차단기를 추가하며 기본값은 false입니다. 영구 시작 영수증이 있고 종료 영수증이 없는 중단된 실행은 재생을 차단합니다. reconcileAgentAssessment는 운영자가 이전 프로세스가 중지되었음을 확인하고, 검토자와 근거를 기록하며, 이전 워커 범위가 여전히 사용 가능한 경우 이를 취소하도록 요구합니다. 반환된 toolCounts, importedRecordIds, importMapRecordId는 기록된 작업과 가져온 증거를 식별합니다. 성공적인 평가 도구 호출이 없는 실행은 실패합니다.
draftAssessmentReport는 이후 단계에서 컨텍스트가 격리된 보고서 작성 단계입니다. 초안만으로는 Pentest MCP가 평가에 도움이 되었다는 것을 보여주지 못합니다. OpenAI, Anthropic, OpenRouter, OpenAI 호환, 로컬 Codex, 로컬 Claude, 컨테이너 Codex, 그리고 구성된 SSH 프로필은 스캐너 도구 없이도 제한된 증거 패킷으로부터 초안을 작성할 수 있습니다. local-agent는 자체 호스팅 CLI 프로필과 루프백 OpenAI 호환 프로필을 허용하지만, 컨텍스트가 전송되기 전에 호스팅 제공자를 거부합니다. 가드된 모델 가이드는 llama.cpp 및 OpenRouter 프로필, 강제 중지 조건, 감사 필드, 그리고 적대적 모델 배포 경계를 제공합니다. 컨테이너 평가 가이드는 CLI 프로필 필드, 실제 수용 명령, 그리고 격리 한계를 제공합니다. 에이전틱 워크플로는 범위, 증거 검토, Daybreak/Glasswing 접근, 그리고 Faxbot 계획을 다룹니다.
릴리스 수용은 scripts/run-real-acceptance.mjs를 사용합니다. 이 스크립트에는 기본 대상이나 권한 부여가 없으며, 설치된 Nmap과 ProjectDiscovery HTTPX가 성공적인 증거 기록을 생성하지 않는 한 통과를 거부합니다. --profile을 사용하면 관리형 에이전트가 Pentest MCP를 통해 두 도구를 모두 호출해야 합니다. --report-profile을 사용하면 별도의 보고서 컨텍스트가 저장된 초안을 생성해야 합니다. 테스트 더블은 자동화된 테스트에만 남아 있으며 수용 영수증으로 제공되지 않습니다.
Node.js 22.19.0 이상과 사용하려는 도구의 호스트 바이너리가 필요합니다. Docker 이미지에는 나열된 도구가 포함되어 있으며, 네이티브 설치의 경우 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
}
}
listEngagementRecords는 요약을 반환하며, 오래된 레코드를 페이지 단위로 조회하기 위해 limit과 offset을 받습니다. getEngagementRecord는 engagementId와 recordId를 모두 받아 허용된 경우 저장된 증거를 반환합니다. 자격 증명 도구는 개수와 출력 다이제스트를 반환합니다. 새로 생성된 인증되지 않은 Gobuster/Nikto 레코드는 소유자 범위 읽기를 위해 비공개 스캐너 출력과 발견 사항을 유지하며, 이전 스캐너 레코드는 계속 마스킹된 상태로 남습니다. Nmap XML과 범위가 제한된 ffuf/Nuclei 기계 출력은 요약과 함께 보존됩니다. 레코드의 outcome은 succeeded, failed, cancelled 중 하나이며, 추적되는 경우 시작 시간과 소요 시간이 포함됩니다. 하위 프로세스 실패는 성공한 스캔 결과가 아니라 감사 레코드를 생성합니다. 사전 점검 범위 거부 시에는 어떤 명령도 시작되지 않습니다. 인증된 HTTP의 경우, engagement 및 증거 접근은 검증된 토큰 소유자로 범위가 제한되며, stdio 데이터는 서버 설치에 로컬로 유지됩니다.
saveAssessmentPlan은 목표, 사람이 읽을 수 있는 허용 및 금지 방법, 정확한 allowedToolNames, 데이터 처리, 중지 조건, 보고서 대상, 작업 소유권, 모델 데이터 정책을 버전이 지정된 증거 레코드로 저장합니다. getAssessmentPlan은 최신 버전을 읽습니다. 관리형 워커는 전체 카탈로그를 받지만, 서버는 allowedToolNames에서 누락된 호출을 핸들러가 실행되기 전에 거부하여 실패한 감사 영수증을 남깁니다. 계획이 존재하는 경우, 그 허용 목록은 14개 평가 메서드에 대한 직접 수동 MCP 호출도 제한하며, 거부는 핸들러나 명령이 실행되기 전에 감사됩니다. 계획이 없는 레거시 engagement에 대한 직접 호출은 이전 동작을 유지하며 여전히 engagement 범위 게이트를 통과합니다. 이 계획은 createEngagement 대상이나 시간을 확장할 수 없습니다. 외부 클라이언트 계획은 모델 초안 작성 전에 제공자 클라이언트 작업 승인 참조가 필요하며, no-model은 결정적 초안만 허용합니다. 계획 스키마 및 예시를 참조하세요.
modelDataPolicy: "local-agent" 또는 "approved-provider"와 비어 있지 않은 allowedToolNames가 있는 계획이 기록된 후, 도구를 사용하는 실행을 시작하세요:
{
"tool": "runAgentAssessment",
"arguments": {
"engagementId": "client-2026-10",
"profileId": "daybreak-cli-assessment",
"timeoutSeconds": 900
}
}
응답에는 실행 ID, 상태, 모델, toolCounts, 가져온 증거 ID, importMapRecordId, 그리고 검토되지 않은 모델 출력의 ID가 포함됩니다. 모델, MCP 자식 또는 평가 도구가 실패하면 재시도하기 전에 보존된 실패와 가져온 레코드를 검사하십시오. 프로세스 중단 후 시작 영수증만 존재하는 경우, 이전 프로세스가 중지되었는지 확인하고 해당 실행 ID, 검토자 신원, 결정 사유와 함께 reconcileAgentAssessment를 호출하십시오. 서버는 실행을 조용히 재생하지 않습니다. 성공적인 평가 도구 호출 없이 종료된 프로세스는 거부되며, 그 제한된 출력은 실패한 결과와 진단용 연결 해시와 함께 비공개로 보존되며, 검증된 발견 증거로는 절대 사용되지 않습니다. 완료된 에이전트 프로세스가 그 관찰을 확인된 발견으로 만들지는 않습니다. 워커는 참여 생성, 종료, 계획 변경, 재귀적 평가 실행, 조정, 보고서 게시를 차단합니다.