How enendugodwin/bug-bounty---kali-linux-vm works
Kali Pentest MCP conducts authorized security assessments and turns scanner evidence into review-ready Markdown and JSON reports. The principal workflow is to select a target, enforce engagement scope, execute a profile or specialized scan, normalize and deduplicate findings, and report results. CLI, MCP, and web GUI provide distinct entry points; persistent jobs expose scan progress, while file-backed memory supports retrieval of past scan results. Several scanner and integration implementations were not excerpted, so their internal call paths are not expanded.
Main entry points: assess.py Profile assessment · scope.py Scope authorization · matrix.py Tool matrix · runner.py Safe command runner
Components 19
User interfaces
- CLI
src/cli.py - MCP server
src/server.py - Web GUI
src/webgui.py
Assessment workflows
- Profile assessment
src/assess.py - Tool matrix
src/matrix.py - CVE scanning
src/cve.py - Intrusive checks
src/intrusive.py - WAF checks
src/waf.py - ZAP scanning
src/zap.py - Security scanners
Findings and reporting
- Finding parsers
src/findings.py - Report generation
src/report.py - Report files
Safety and persistence
- Scope authorization
src/scope.py - Safe command runner
src/runner.py - Scan history
src/jobs.py - Scan memory
src/memory.py - Raw artifacts
Other components
- Operator
Connections 33
- Operator → CLI: runs commands
README.md - Operator → MCP server: requests tools
README.md - Operator → Web GUI: uses interface
README.md - CLI → Profile assessment: starts assessment
src/cli.py - CLI → Scope authorization: checks scope
src/cli.py - MCP server → Profile assessment: starts assessment
src/server.py - MCP server → Tool matrix: starts matrix
src/server.py - Web GUI → Scope authorization: edits scope
src/webgui.py - Web GUI → Scan history: reads status
src/webgui.py - Web GUI → Report files: downloads reports
README.md - Profile assessment → Scope authorization: authorizes target
src/assess.py - Profile assessment → Safe command runner: executes commands
src/assess.py - Profile assessment → Finding parsers: parses and deduplicates
src/assess.py - Profile assessment → Scan history: records scan progress
src/assess.py - Profile assessment → Scan memory: stores scan output
src/assess.py - Profile assessment → Report generation: writes assessment
src/assess.py - Tool matrix → Scope authorization: checks authorization
src/matrix.py - Tool matrix → Safe command runner: executes commands
src/matrix.py - Tool matrix → Finding parsers: normalizes results
src/matrix.py - Tool matrix → Scan history: records scan progress
src/matrix.py - Tool matrix → Report generation: writes report
src/matrix.py - CVE scanning → Scope authorization: clamps scan scope
src/cve.py - CVE scanning → Safe command runner: executes commands
src/cve.py - CVE scanning → Finding parsers: parses CVE results
src/cve.py - CVE scanning → Report generation: writes report
src/cve.py - Intrusive checks → Scope authorization: checks authorization
src/intrusive.py - WAF checks → Scope authorization: checks authorization
src/waf.py - WAF checks → Safe command runner: executes commands
src/waf.py - ZAP scanning → Scope authorization: checks authorization
src/zap.py - Safe command runner → Security scanners: runs scanner tools
README.md - Report generation → Finding parsers: renders findings
src/report.py - Report generation → Report files: writes Markdown and JSON
README.md - Safe command runner → Raw artifacts: captures evidence
src/runner.py