crhacky/blhackbox repository overview

docker compose pull    # pull ALL images (custom + official) in one command

Claude Code ──┬──▶ Kali MCP (SSE :9001)
(container)   │    70+ tools: nmap, sqlmap, hydra, msfconsole, msfvenom…
              │
              ├──▶ WireMCP (SSE :9003)
              │    7 tools: packet capture, pcap analysis, credential extraction
              │
              ├──▶ Screenshot MCP (SSE :9004)
              │    4 tools: web screenshots, element capture, annotations
              │
              │  After collecting raw outputs, Claude structures them directly:
              │    get_payload_schema() → parse/dedup/correlate → aggregate_results()
              │
              ▼
output/          Host-mounted directory for reports, screenshots, sessions
Portainer        Docker UI (https://localhost:9443)
Neo4j            Cross-session memory (optional)

Claude Desktop ──▶ MCP Gateway (localhost:8080/mcp) ──┬──▶ Kali MCP
(host app)                                             ├──▶ WireMCP
                                                       └──▶ Screenshot MCP

git clone https://github.com/valITino/blhackbox.git
cd blhackbox
./setup.sh    # interactive wizard: prereqs, .env, pull, start, health

git clone https://github.com/valITino/blhackbox.git && cd blhackbox
cp .env.example .env
# REQUIRED: set ANTHROPIC_API_KEY=sk-ant-... in .env
mkdir -p output/reports output/screenshots output/sessions
docker compose pull
docker compose up -d

make claude-code    # builds + launches Claude Code in Docker

make up-gateway     # starts core + gateway on port 8080

docker compose --profile neo4j up -d

make status         # container status table
make health         # MCP server health check

{
  "mcpServers": {
    "kali":       { "type": "sse", "url": "http://kali-mcp:9001/sse" },
    "wireshark":  { "type": "sse", "url": "http://wire-mcp:9003/sse" },
    "screenshot": { "type": "sse", "url": "http://screenshot-mcp:9004/sse" }
  }
}

{
  "mcpServers": {
    "blhackbox": {
      "transport": "streamable-http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

PR opened  ─────▶  CI (lint + test + pip-audit)
                        │
PR merged  ─────▶  CI  ─────▶  Build & Push (4 images)  ─────▶  Docker Hub
                                (on CI success)

Tag v*     ──────────────────▶  Build & Push (4 images)  ─────▶  Docker Hub

Manual     ──────────────────▶  Build & Push (4 images)  ─────▶  Docker Hub

make setup              # Interactive setup wizard (first-time setup)
docker compose pull     # Pull all pre-built images
docker compose up -d    # Start core stack (4 containers)
make up-gateway         # Start with MCP Gateway (5 containers)
make claude-code        # Launch Claude Code in Docker
make health             # Health check all MCP servers
make status             # Container status table
make logs-kali          # Kali MCP logs
make logs-wireshark     # WireMCP logs
make logs-screenshot    # Screenshot MCP logs
make gateway-logs       # MCP Gateway logs
make down               # Stop all services
make clean              # Stop + remove volumes