# enendugodwin/bug-bounty---kali-linux-vm architecture

> Architecture diagram of the GitHub repository enendugodwin/bug-bounty---kali-linux-vm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/enendugodwin/bug-bounty---kali-linux-vm
- Repository: https://github.com/enendugodwin/bug-bounty---kali-linux-vm

## Overview

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: [`src/assess.py`](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/assess.py) (Profile assessment), [`src/scope.py`](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/scope.py) (Scope authorization), [`src/matrix.py`](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/matrix.py) (Tool matrix), [`src/runner.py`](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/runner.py) (Safe command runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["CLI<br/>[cli.py]"]
  node_mcp["MCP server<br/>[server.py]"]
  node_gui["Web GUI<br/>[webgui.py]"]
end

subgraph group_assessment["Assessment workflows"]
  node_assess["Profile assessment<br/>[assess.py]"]
  node_matrix["Tool matrix<br/>[matrix.py]"]
  node_cve["CVE scanning<br/>[cve.py]"]
  node_intrusive["Intrusive checks<br/>[intrusive.py]"]
  node_waf["WAF checks<br/>[waf.py]"]
  node_zap["ZAP scanning<br/>[zap.py]"]
  node_scanner_tools["Security scanners"]
end

subgraph group_analysis["Findings and reporting"]
  node_findings["Finding parsers<br/>[findings.py]"]
  node_report["Report generation<br/>[report.py]"]
  node_reports["Report files"]
end

subgraph group_platform["Safety and persistence"]
  node_scope["Scope authorization<br/>[scope.py]"]
  node_runner["Safe command runner<br/>[runner.py]"]
  node_jobs[("Scan history<br/>[jobs.py]")]
  node_memory[("Scan memory<br/>[memory.py]")]
  node_artifacts["Raw artifacts"]
end

node_operator(("Operator"))

node_operator -->|"runs commands"| node_cli
node_operator -->|"requests tools"| node_mcp
node_operator -->|"uses interface"| node_gui
node_cli -->|"starts assessment"| node_assess
node_cli -->|"checks scope"| node_scope
node_mcp -->|"starts assessment"| node_assess
node_mcp -->|"starts matrix"| node_matrix
node_gui -->|"edits scope"| node_scope
node_gui -->|"reads status"| node_jobs
node_gui -->|"downloads reports"| node_reports
node_assess -->|"authorizes target"| node_scope
node_assess -->|"executes commands"| node_runner
node_assess -->|"parses and deduplicates"| node_findings
node_assess -->|"records scan progress"| node_jobs
node_assess -->|"stores scan output"| node_memory
node_assess -->|"writes assessment"| node_report
node_matrix -->|"checks authorization"| node_scope
node_matrix -->|"executes commands"| node_runner
node_matrix -->|"normalizes results"| node_findings
node_matrix -->|"records scan progress"| node_jobs
node_matrix -->|"writes report"| node_report
node_cve -->|"clamps scan scope"| node_scope
node_cve -->|"executes commands"| node_runner
node_cve -->|"parses CVE results"| node_findings
node_cve -->|"writes report"| node_report
node_intrusive -->|"checks authorization"| node_scope
node_waf -->|"checks authorization"| node_scope
node_waf -->|"executes commands"| node_runner
node_zap -->|"checks authorization"| node_scope
node_runner -.->|"runs scanner tools"| node_scanner_tools
node_report -->|"renders findings"| node_findings
node_report -->|"writes Markdown and JSON"| node_reports
node_runner -->|"captures evidence"| node_artifacts

click node_cli "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/cli.py"
click node_mcp "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/server.py"
click node_gui "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/webgui.py"
click node_assess "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/assess.py"
click node_matrix "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/matrix.py"
click node_cve "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/cve.py"
click node_intrusive "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/intrusive.py"
click node_waf "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/waf.py"
click node_zap "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/zap.py"
click node_scope "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/scope.py"
click node_runner "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/runner.py"
click node_jobs "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/jobs.py"
click node_memory "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/memory.py"
click node_findings "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/findings.py"
click node_report "https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/report.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_mcp,node_gui toneBlue
class node_assess,node_matrix,node_cve,node_intrusive,node_waf,node_zap,node_scanner_tools toneAmber
class node_findings,node_report,node_reports toneMint
class node_scope,node_runner,node_jobs,node_memory,node_artifacts toneRose
class node_operator toneIndigo
```

## Components

### User interfaces

- [CLI](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/cli.py): `src/cli.py`
- [MCP server](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/server.py): `src/server.py`
- [Web GUI](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/webgui.py): `src/webgui.py`

### Assessment workflows

- [Profile assessment](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/assess.py): `src/assess.py`
- [Tool matrix](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/matrix.py): `src/matrix.py`
- [CVE scanning](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/cve.py): `src/cve.py`
- [Intrusive checks](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/intrusive.py): `src/intrusive.py`
- [WAF checks](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/waf.py): `src/waf.py`
- [ZAP scanning](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/zap.py): `src/zap.py`
- **Security scanners**

### Findings and reporting

- [Finding parsers](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/findings.py): `src/findings.py`
- [Report generation](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/report.py): `src/report.py`
- **Report files**

### Safety and persistence

- [Scope authorization](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/scope.py): `src/scope.py`
- [Safe command runner](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/runner.py): `src/runner.py`
- [Scan history](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/jobs.py): `src/jobs.py`
- [Scan memory](https://github.com/enendugodwin/bug-bounty---kali-linux-vm/blob/main/src/memory.py): `src/memory.py`
- **Raw artifacts**

### Other components

- **Operator**

## Connections

- Operator → CLI: runs commands (evidence: `README.md`)
- Operator → MCP server: requests tools (evidence: `README.md`)
- Operator → Web GUI: uses interface (evidence: `README.md`)
- CLI → Profile assessment: starts assessment (evidence: `src/cli.py`)
- CLI → Scope authorization: checks scope (evidence: `src/cli.py`)
- MCP server → Profile assessment: starts assessment (evidence: `src/server.py`)
- MCP server → Tool matrix: starts matrix (evidence: `src/server.py`)
- Web GUI → Scope authorization: edits scope (evidence: `src/webgui.py`)
- Web GUI → Scan history: reads status (evidence: `src/webgui.py`)
- Web GUI → Report files: downloads reports (evidence: `README.md`)
- Profile assessment → Scope authorization: authorizes target (evidence: `src/assess.py`)
- Profile assessment → Safe command runner: executes commands (evidence: `src/assess.py`)
- Profile assessment → Finding parsers: parses and deduplicates (evidence: `src/assess.py`)
- Profile assessment → Scan history: records scan progress (evidence: `src/assess.py`)
- Profile assessment → Scan memory: stores scan output (evidence: `src/assess.py`)
- Profile assessment → Report generation: writes assessment (evidence: `src/assess.py`)
- Tool matrix → Scope authorization: checks authorization (evidence: `src/matrix.py`)
- Tool matrix → Safe command runner: executes commands (evidence: `src/matrix.py`)
- Tool matrix → Finding parsers: normalizes results (evidence: `src/matrix.py`)
- Tool matrix → Scan history: records scan progress (evidence: `src/matrix.py`)
- Tool matrix → Report generation: writes report (evidence: `src/matrix.py`)
- CVE scanning → Scope authorization: clamps scan scope (evidence: `src/cve.py`)
- CVE scanning → Safe command runner: executes commands (evidence: `src/cve.py`)
- CVE scanning → Finding parsers: parses CVE results (evidence: `src/cve.py`)
- CVE scanning → Report generation: writes report (evidence: `src/cve.py`)
- Intrusive checks → Scope authorization: checks authorization (evidence: `src/intrusive.py`)
- WAF checks → Scope authorization: checks authorization (evidence: `src/waf.py`)
- WAF checks → Safe command runner: executes commands (evidence: `src/waf.py`)
- ZAP scanning → Scope authorization: checks authorization (evidence: `src/zap.py`)
- Safe command runner → Security scanners: runs scanner tools (evidence: `README.md`)
- Report generation → Finding parsers: renders findings (evidence: `src/report.py`)
- Report generation → Report files: writes Markdown and JSON (evidence: `README.md`)
- Safe command runner → Raw artifacts: captures evidence (evidence: `src/runner.py`)
