# 0x4m4/hexstrike-ai architecture

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

- Interactive diagram: https://gitdiagram.com/0x4m4/hexstrike-ai
- Repository: https://github.com/0x4m4/hexstrike-ai

## Overview

HexStrike AI is an MCP cybersecurity automation platform: an AI client invokes registered MCP tools, which forward security operations to the server; the documented server architecture adds intelligence, autonomous agents, visual reporting, and process management. The README describes several server-side capabilities not visible in the sampled source, so those branches are documented rather than source-verified.

Main entry points: [`hexstrike_server.py`](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py) (Security tools), [`hexstrike_mcp.py`](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_mcp.py) (MCP tool client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["MCP interface"]
  node_mcp_client["MCP tool client<br/>[hexstrike_mcp.py]"]
  node_server["HexStrike server"]
end

subgraph group_analysis["Intelligence and agents"]
  node_decision["Decision engine"]
  node_tool_selection["Tool selection"]
  node_parameter_optimization["Parameter optimization"]
  node_attack_chains["Attack chain discovery"]
  node_autonomous_agents["Autonomous agents"]
  node_bug_bounty["Bug bounty agent"]
  node_ctf_agent["CTF solver"]
  node_cve_agent["CVE intelligence"]
  node_exploit_agent["Exploit generator"]
end

subgraph group_execution["Security execution"]
  node_security_tools["Security tools"]
  node_network_tools["Network tools"]
  node_web_tools["Web application tools"]
  node_cloud_tools["Cloud tools"]
  node_binary_tools["Binary tools"]
  node_ctf_tools["CTF tools"]
  node_osint_tools["OSINT tools"]
end

subgraph group_operations["Output and operations"]
  node_visual_engine["Visual engine"]
  node_dashboards["Real-time dashboards"]
  node_progress["Progress visualization"]
  node_vulnerability_cards["Vulnerability cards"]
  node_process_management["Process management"]
  node_caching["Smart caching"]
  node_resource_optimization["Resource optimization"]
  node_error_recovery["Error recovery"]
end

node_ai_agent(("AI agent"))

node_ai_agent -->|"uses MCP"| node_mcp_client
node_mcp_client -->|"sends tool requests"| node_server
node_server -->|"delegates analysis"| node_decision
node_decision -->|"selects tools"| node_tool_selection
node_decision -->|"optimizes parameters"| node_parameter_optimization
node_decision -->|"discovers chains"| node_attack_chains
node_server -->|"runs agents"| node_autonomous_agents
node_autonomous_agents -->|"includes"| node_bug_bounty
node_autonomous_agents -->|"includes"| node_ctf_agent
node_autonomous_agents -->|"includes"| node_cve_agent
node_autonomous_agents -->|"includes"| node_exploit_agent
node_server -->|"dispatches scans"| node_security_tools
node_security_tools -->|"covers"| node_network_tools
node_security_tools -->|"covers"| node_web_tools
node_security_tools -->|"covers"| node_cloud_tools
node_security_tools -->|"covers"| node_binary_tools
node_security_tools -->|"covers"| node_ctf_tools
node_security_tools -->|"covers"| node_osint_tools
node_server -->|"provides visualization"| node_visual_engine
node_visual_engine -->|"renders"| node_dashboards
node_visual_engine -->|"visualizes"| node_progress
node_visual_engine -->|"presents findings"| node_vulnerability_cards
node_server -->|"manages execution"| node_process_management
node_process_management -->|"uses"| node_caching
node_process_management -->|"optimizes"| node_resource_optimization
node_process_management -->|"recovers from failures"| node_error_recovery

click node_mcp_client "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_mcp.py"
click node_server "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_decision "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_tool_selection "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_parameter_optimization "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_attack_chains "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_autonomous_agents "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_bug_bounty "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_ctf_agent "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_cve_agent "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_exploit_agent "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_security_tools "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_network_tools "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_web_tools "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_cloud_tools "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_binary_tools "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_ctf_tools "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_osint_tools "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_visual_engine "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_dashboards "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_progress "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_vulnerability_cards "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_process_management "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_caching "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_resource_optimization "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py"
click node_error_recovery "https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_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_mcp_client,node_server toneBlue
class node_decision,node_tool_selection,node_parameter_optimization,node_attack_chains,node_autonomous_agents,node_bug_bounty,node_ctf_agent,node_cve_agent,node_exploit_agent toneAmber
class node_security_tools,node_network_tools,node_web_tools,node_cloud_tools,node_binary_tools,node_ctf_tools,node_osint_tools toneMint
class node_visual_engine,node_dashboards,node_progress,node_vulnerability_cards,node_process_management,node_caching,node_resource_optimization,node_error_recovery toneRose
class node_ai_agent toneIndigo
```

## Components

### MCP interface

- [MCP tool client](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_mcp.py): `hexstrike_mcp.py`
- [HexStrike server](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`

### Intelligence and agents

- [Decision engine](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Tool selection](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Parameter optimization](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Attack chain discovery](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Autonomous agents](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Bug bounty agent](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [CTF solver](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [CVE intelligence](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Exploit generator](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`

### Security execution

- [Security tools](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Network tools](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Web application tools](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Cloud tools](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Binary tools](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [CTF tools](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [OSINT tools](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`

### Output and operations

- [Visual engine](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Real-time dashboards](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Progress visualization](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Vulnerability cards](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Process management](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Smart caching](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Resource optimization](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`
- [Error recovery](https://github.com/0x4m4/hexstrike-ai/blob/master/hexstrike_server.py): `hexstrike_server.py`

### Other components

- **AI agent**

## Connections

- AI agent → MCP tool client: uses MCP (evidence: `README.md`)
- MCP tool client → HexStrike server: sends tool requests (evidence: `hexstrike_mcp.py`)
- HexStrike server → Decision engine: delegates analysis (evidence: `README.md`)
- Decision engine → Tool selection: selects tools (evidence: `README.md`)
- Decision engine → Parameter optimization: optimizes parameters (evidence: `README.md`)
- Decision engine → Attack chain discovery: discovers chains (evidence: `README.md`)
- HexStrike server → Autonomous agents: runs agents (evidence: `README.md`)
- Autonomous agents → Bug bounty agent: includes (evidence: `README.md`)
- Autonomous agents → CTF solver: includes (evidence: `README.md`)
- Autonomous agents → CVE intelligence: includes (evidence: `README.md`)
- Autonomous agents → Exploit generator: includes (evidence: `README.md`)
- HexStrike server → Security tools: dispatches scans
- Security tools → Network tools: covers (evidence: `README.md`)
- Security tools → Web application tools: covers (evidence: `README.md`)
- Security tools → Cloud tools: covers (evidence: `README.md`)
- Security tools → Binary tools: covers (evidence: `README.md`)
- Security tools → CTF tools: covers (evidence: `README.md`)
- Security tools → OSINT tools: covers (evidence: `README.md`)
- HexStrike server → Visual engine: provides visualization (evidence: `README.md`)
- Visual engine → Real-time dashboards: renders (evidence: `README.md`)
- Visual engine → Progress visualization: visualizes (evidence: `README.md`)
- Visual engine → Vulnerability cards: presents findings (evidence: `README.md`)
- HexStrike server → Process management: manages execution (evidence: `README.md`)
- Process management → Smart caching: uses (evidence: `README.md`)
- Process management → Resource optimization: optimizes (evidence: `README.md`)
- Process management → Error recovery: recovers from failures (evidence: `README.md`)
