# 0x7ak7/redvector architecture

> Architecture diagram of the GitHub repository 0x7ak7/redvector, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/0x7ak7/redvector
- Repository: https://github.com/0x7ak7/redvector

## Overview

RedVector exposes cybersecurity assessment capabilities to MCP-compatible AI clients, which submit tasks through the MCP layer to a Flask backend. The backend validates and orchestrates execution, invokes host-installed security tools, and returns structured results. README documents workflow engines, process recovery, and reporting, but the sampled server source was unavailable; those relationships are therefore grounded in its architecture description rather than inspected implementation. The banner and native-tool manager are separate runtime capabilities; their connection to backend routes is not shown.

Main entry points: [`redvector_server.py`](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py) (Flask API), [`redvector_mcp.py`](https://github.com/0x7ak7/redvector/blob/main/redvector_mcp.py) (MCP tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["AI access"]
  node_ai(("AI client"))
  node_mcp["MCP tools<br/>[redvector_mcp.py]"]
  node_banner["Startup banner"]
end

subgraph group_backend["Execution backend"]
  node_server["Flask API"]
  node_manager["Native tool manager"]
  node_execution["Process execution"]
  node_recovery[("Cache and recovery")]
  node_results["Results and reports"]
end

subgraph group_workflows["Assessment workflows"]
  node_decision["Decision workflows"]
  node_recon["Recon and OSINT"]
  node_discovery["Vulnerability discovery"]
  node_validation["Validation and exploit research"]
  node_postexploit["Post-exploitation"]
  node_specialized["Specialized assessments"]
end

subgraph group_integrations["Security integrations"]
  node_recon_tools["Recon and network tools"]
  node_web_tools["Web and API tools"]
  node_ad_tools["AD and Windows tools"]
  node_cloud_tools["Cloud and container tools"]
  node_binary_tools["Binary and forensics tools"]
  node_host_tools["Installed security tools"]
end

node_ai -->|"selects tools"| node_mcp
node_mcp -->|"sends HTTP requests"| node_server
node_server -->|"orchestrates workflows"| node_decision
node_server -->|"dispatches commands"| node_execution
node_server -->|"manages processes"| node_recovery
node_server -->|"collects results"| node_results
node_decision -->|"produces reports"| node_results
node_execution -->|"invokes tools"| node_recon_tools
node_execution -->|"invokes tools"| node_web_tools
node_execution -->|"invokes tools"| node_ad_tools
node_execution -->|"invokes tools"| node_cloud_tools
node_execution -->|"invokes tools"| node_binary_tools
node_recon -->|"guides workflow"| node_discovery
node_discovery -->|"guides workflow"| node_validation
node_validation -->|"guides workflow"| node_postexploit
node_server -->|"hosts workflows"| node_recon
node_server -->|"hosts workflows"| node_specialized
node_execution -->|"runs installed tools"| node_host_tools

click node_mcp "https://github.com/0x7ak7/redvector/blob/main/redvector_mcp.py"
click node_banner "https://github.com/0x7ak7/redvector/blob/main/redvector_banner.py"
click node_server "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_manager "https://github.com/0x7ak7/redvector/blob/main/redvector_tool_manager.py"
click node_execution "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_recovery "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_results "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_decision "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_recon "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_discovery "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_validation "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_postexploit "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_specialized "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_recon_tools "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_web_tools "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_ad_tools "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_cloud_tools "https://github.com/0x7ak7/redvector/blob/main/redvector_server.py"
click node_binary_tools "https://github.com/0x7ak7/redvector/blob/main/redvector_server.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_ai,node_mcp,node_banner toneBlue
class node_server,node_manager,node_execution,node_recovery,node_results toneAmber
class node_decision,node_recon,node_discovery,node_validation,node_postexploit,node_specialized toneMint
class node_recon_tools,node_web_tools,node_ad_tools,node_cloud_tools,node_binary_tools,node_host_tools toneRose
```

## Components

### AI access

- **AI client**
- [MCP tools](https://github.com/0x7ak7/redvector/blob/main/redvector_mcp.py): `redvector_mcp.py`
- [Startup banner](https://github.com/0x7ak7/redvector/blob/main/redvector_banner.py): `redvector_banner.py`

### Execution backend

- [Flask API](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Native tool manager](https://github.com/0x7ak7/redvector/blob/main/redvector_tool_manager.py): `redvector_tool_manager.py`
- [Process execution](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Cache and recovery](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Results and reports](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`

### Assessment workflows

- [Decision workflows](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Recon and OSINT](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Vulnerability discovery](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Validation and exploit research](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Post-exploitation](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Specialized assessments](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`

### Security integrations

- [Recon and network tools](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Web and API tools](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [AD and Windows tools](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Cloud and container tools](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- [Binary and forensics tools](https://github.com/0x7ak7/redvector/blob/main/redvector_server.py): `redvector_server.py`
- **Installed security tools**

## Connections

- AI client → MCP tools: selects tools (evidence: `README.md`)
- MCP tools → Flask API: sends HTTP requests (evidence: `redvector_mcp.py`)
- Flask API → Decision workflows: orchestrates workflows (evidence: `README.md`)
- Flask API → Process execution: dispatches commands (evidence: `README.md`)
- Flask API → Cache and recovery: manages processes (evidence: `README.md`)
- Flask API → Results and reports: collects results (evidence: `README.md`)
- Decision workflows → Results and reports: produces reports (evidence: `README.md`)
- Process execution → Recon and network tools: invokes tools (evidence: `README.md`)
- Process execution → Web and API tools: invokes tools (evidence: `README.md`)
- Process execution → AD and Windows tools: invokes tools (evidence: `README.md`)
- Process execution → Cloud and container tools: invokes tools (evidence: `README.md`)
- Process execution → Binary and forensics tools: invokes tools (evidence: `README.md`)
- Recon and OSINT → Vulnerability discovery: guides workflow (evidence: `README.md`)
- Vulnerability discovery → Validation and exploit research: guides workflow (evidence: `README.md`)
- Validation and exploit research → Post-exploitation: guides workflow (evidence: `README.md`)
- Flask API → Recon and OSINT: hosts workflows (evidence: `README.md`)
- Flask API → Specialized assessments: hosts workflows (evidence: `README.md`)
- Process execution → Installed security tools: runs installed tools (evidence: `README.md`)