hexstrike-ai README

The project's README from github.com/0x4m4/hexstrike-ai. As one markdown file: README.md.

HexStrike AI Logo

HexStrike AI MCP Agents v6.0

AI-Powered MCP Cybersecurity Automation Platform

Python License Security MCP Version Tools Agents Stars

Advanced AI-powered penetration testing MCP framework with 150+ security tools and 12+ autonomous AI agents

Owned & developed by OTT Cybersecurity LLC

📋 What's New • 🏗️ Architecture • 🚀 Installation • 🛠️ Features • 🤖 AI Agents • 📡 API Reference


Follow Our Social Accounts

Join our Discord    Follow us on LinkedIn


Architecture Overview

HexStrike AI MCP v6.0 features a multi-agent architecture with autonomous AI agents, intelligent decision-making, and vulnerability intelligence.

%%{init: {"themeVariables": {
  "primaryColor": "#b71c1c",
  "secondaryColor": "#ff5252",
  "tertiaryColor": "#ff8a80",
  "background": "#2d0000",
  "edgeLabelBackground":"#b71c1c",
  "fontFamily": "monospace",
  "fontSize": "16px",
  "fontColor": "#fffde7",
  "nodeTextColor": "#fffde7"
}}}%%
graph TD
    A[AI Agent - Claude/GPT/Copilot] -->|MCP Protocol| B[HexStrike MCP Server v6.0]
    
    B --> C[Intelligent Decision Engine]
    B --> D[12+ Autonomous AI Agents]
    B --> E[Modern Visual Engine]
    
    C --> F[Tool Selection AI]
    C --> G[Parameter Optimization]
    C --> H[Attack Chain Discovery]
    
    D --> I[BugBounty Agent]
    D --> J[CTF Solver Agent]
    D --> K[CVE Intelligence Agent]
    D --> L[Exploit Generator Agent]
    
    E --> M[Real-time Dashboards]
    E --> N[Progress Visualization]
    E --> O[Vulnerability Cards]
    
    B --> P[150+ Security Tools]
    P --> Q[Network Tools - 25+]
    P --> R[Web App Tools - 40+]
    P --> S[Cloud Tools - 20+]
    P --> T[Binary Tools - 25+]
    P --> U[CTF Tools - 20+]
    P --> V[OSINT Tools - 20+]
    
    B --> W[Advanced Process Management]
    W --> X[Smart Caching]
    W --> Y[Resource Optimization]
    W --> Z[Error Recovery]
    
    style A fill:#b71c1c,stroke:#ff5252,stroke-width:3px,color:#fffde7
    style B fill:#ff5252,stroke:#b71c1c,stroke-width:4px,color:#fffde7
    style C fill:#ff8a80,stroke:#b71c1c,stroke-width:2px,color:#fffde7
    style D fill:#ff8a80,stroke:#b71c1c,stroke-width:2px,color:#fffde7
    style E fill:#ff8a80,stroke:#b71c1c,stroke-width:2px,color:#fffde7

How It Works

  1. AI Agent Connection - Claude, GPT, or other MCP-compatible agents connect via FastMCP protocol
  2. Intelligent Analysis - Decision engine analyzes targets and selects optimal testing strategies
  3. Autonomous Execution - AI agents execute comprehensive security assessments
  4. Real-time Adaptation - System adapts based on results and discovered vulnerabilities
  5. Advanced Reporting - Visual output with vulnerability cards and risk analysis

Installation

Quick Setup to Run the hexstrike MCPs Server

# 1. Clone the repository
git clone https://github.com/0x4m4/hexstrike-ai.git
cd hexstrike-ai

# 2. Create virtual environment
python3 -m venv hexstrike-env
source hexstrike-env/bin/activate  # Linux/Mac
# hexstrike-env\Scripts\activate   # Windows

# 3. Install Python dependencies
pip3 install -r requirements.txt

Installation and Setting Up Guide for various AI Clients:

Installation & Demo Video

Watch the full installation and setup walkthrough here: YouTube - HexStrike AI Installation & Demo

Supported AI Clients for Running & Integration

You can install and run HexStrike AI MCPs with various AI clients, including:

Refer to the video above for step-by-step instructions and integration examples for these platforms.

Install Security Tools

Core Tools (Essential):

# Network & Reconnaissance
nmap masscan rustscan amass subfinder nuclei fierce dnsenum
autorecon theharvester responder netexec enum4linux-ng

# Web Application Security
gobuster feroxbuster dirsearch ffuf dirb httpx katana
nikto sqlmap wpscan arjun paramspider dalfox wafw00f

# Password & Authentication
hydra john hashcat medusa patator crackmapexec
evil-winrm hash-identifier ophcrack

# Binary Analysis & Reverse Engineering
gdb radare2 binwalk ghidra checksec strings objdump
volatility3 foremost steghide exiftool

Cloud Security Tools:

prowler scout-suite trivy
kube-hunter kube-bench docker-bench-security

Browser Agent Requirements:

# Chrome/Chromium for Browser Agent
sudo apt install chromium-browser chromium-chromedriver
# OR install Google Chrome
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt update && sudo apt install google-chrome-stable

Start the Server

# Start the MCP server
python3 hexstrike_server.py

# Optional: Start with debug mode
python3 hexstrike_server.py --debug

# Optional: Custom port configuration
python3 hexstrike_server.py --port 8888

Verify Installation

# Test server health
curl http://localhost:8888/health

# Test AI agent capabilities
curl -X POST http://localhost:8888/api/intelligence/analyze-target \
  -H "Content-Type: application/json" \
  -d '{"target": "example.com", "analysis_type": "comprehensive"}'

AI Client Integration Setup

Claude Desktop Integration or Cursor

Edit ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hexstrike-ai": {
      "command": "python3",
      "args": [
        "/path/to/hexstrike-ai/hexstrike_mcp.py",
        "--server",
        "http://localhost:8888"
      ],
      "description": "HexStrike AI v6.0 - Advanced Cybersecurity Automation Platform",
      "timeout": 300,
      "disabled": false
    }
  }
}

VS Code Copilot Integration

Configure VS Code settings in .vscode/settings.json:

{
  "servers": {
    "hexstrike": {
      "type": "stdio",
      "command": "python3",
      "args": [
        "/path/to/hexstrike-ai/hexstrike_mcp.py",
        "--server",
        "http://localhost:8888"
      ]
    }
  },
  "inputs": []
}

Features

Security Tools Arsenal

150+ Professional Security Tools:

🔍 Network Reconnaissance & Scanning (25+ Tools)
  • Nmap - Advanced port scanning with custom NSE scripts and service detection
  • Rustscan - Ultra-fast port scanner with intelligent rate limiting
  • Masscan - High-speed Internet-scale port scanning with banner grabbing
  • AutoRecon - Comprehensive automated reconnaissance with 35+ parameters
  • Amass - Advanced subdomain enumeration and OSINT gathering
  • Subfinder - Fast passive subdomain discovery with multiple sources
  • Fierce - DNS reconnaissance and zone transfer testing
  • DNSEnum - DNS information gathering and subdomain brute forcing
  • TheHarvester - Email and subdomain harvesting from multiple sources
  • ARP-Scan - Network discovery using ARP requests
  • NBTScan - NetBIOS name scanning and enumeration
  • RPCClient - RPC enumeration and null session testing
  • Enum4linux - SMB enumeration with user, group, and share discovery
  • Enum4linux-ng - Advanced SMB enumeration with enhanced logging
  • SMBMap - SMB share enumeration and exploitation
  • Responder - LLMNR, NBT-NS and MDNS poisoner for credential harvesting
  • NetExec - Network service exploitation framework (formerly CrackMapExec)
🌐 Web Application Security Testing (40+ Tools)
  • Gobuster - Directory, file, and DNS enumeration with intelligent wordlists
  • Dirsearch - Advanced directory and file discovery with enhanced logging
  • Feroxbuster - Recursive content discovery with intelligent filtering
  • FFuf - Fast web fuzzer with advanced filtering and parameter discovery
  • Dirb - Comprehensive web content scanner with recursive scanning
  • HTTPx - Fast HTTP probing and technology detection
  • Katana - Next-generation crawling and spidering with JavaScript support
  • Hakrawler - Fast web endpoint discovery and crawling
  • Gau - Get All URLs from multiple sources (Wayback, Common Crawl, etc.)
  • Waybackurls - Historical URL discovery from Wayback Machine
  • Nuclei - Fast vulnerability scanner with 4000+ templates
  • Nikto - Web server vulnerability scanner with comprehensive checks
  • SQLMap - Advanced automatic SQL injection testing with tamper scripts
  • WPScan - WordPress security scanner with vulnerability database
  • Arjun - HTTP parameter discovery with intelligent fuzzing
  • ParamSpider - Parameter mining from web archives
  • X8 - Hidden parameter discovery with advanced techniques
  • Jaeles - Advanced vulnerability scanning with custom signatures
  • Dalfox - Advanced XSS vulnerability scanning with DOM analysis
  • Wafw00f - Web application firewall fingerprinting
  • TestSSL - SSL/TLS configuration testing and vulnerability assessment
  • SSLScan - SSL/TLS cipher suite enumeration
  • SSLyze - Fast and comprehensive SSL/TLS configuration analyzer
  • Anew - Append new lines to files for efficient data processing
  • QSReplace - Query string parameter replacement for systematic testing
  • Uro - URL filtering and deduplication for efficient testing
  • Whatweb - Web technology identification with fingerprinting
  • JWT-Tool - JSON Web Token testing with algorithm confusion
  • GraphQL-Voyager - GraphQL schema exploration and introspection testing
  • Burp Suite Extensions - Custom extensions for advanced web testing
  • ZAP Proxy - OWASP ZAP integration for automated security scanning
  • Wfuzz - Web application fuzzer with advanced payload generation
  • Commix - Command injection exploitation tool with automated detection
  • NoSQLMap - NoSQL injection testing for MongoDB, CouchDB, etc.
  • Tplmap - Server-side template injection exploitation tool

🌐 Advanced Browser Agent:

  • Headless Chrome Automation - Full Chrome browser automation with Selenium
  • Screenshot Capture - Automated screenshot generation for visual inspection
  • DOM Analysis - Deep DOM tree analysis and JavaScript execution monitoring
  • Network Traffic Monitoring - Real-time network request/response logging
  • Security Header Analysis - Comprehensive security header validation
  • Form Detection & Analysis - Automatic form discovery and input field analysis
  • JavaScript Execution - Dynamic content analysis with full JavaScript support
  • Proxy Integration - Seamless integration with Burp Suite and other proxies
  • Multi-page Crawling - Intelligent web application spidering and mapping
  • Performance Metrics - Page load times, resource usage, and optimization insights
🔐 Authentication & Password Security (12+ Tools)
  • Hydra - Network login cracker supporting 50+ protocols
  • John the Ripper - Advanced password hash cracking with custom rules
  • Hashcat - World's fastest password recovery tool with GPU acceleration
  • Medusa - Speedy, parallel, modular login brute-forcer
  • Patator - Multi-purpose brute-forcer with advanced modules
  • NetExec - Swiss army knife for pentesting networks
  • SMBMap - SMB share enumeration and exploitation tool
  • Evil-WinRM - Windows Remote Management shell with PowerShell integration
  • Hash-Identifier - Hash type identification tool
  • HashID - Advanced hash algorithm identifier with confidence scoring
  • CrackStation - Online hash lookup integration
  • Ophcrack - Windows password cracker using rainbow tables
🔬 Binary Analysis & Reverse Engineering (25+ Tools)
  • GDB - GNU Debugger with Python scripting and exploit development support
  • GDB-PEDA - Python Exploit Development Assistance for GDB
  • GDB-GEF - GDB Enhanced Features for exploit development
  • Radare2 - Advanced reverse engineering framework with comprehensive analysis
  • Ghidra - NSA's software reverse engineering suite with headless analysis
  • IDA Free - Interactive disassembler with advanced analysis capabilities
  • Binary Ninja - Commercial reverse engineering platform
  • Binwalk - Firmware analysis and extraction tool with recursive extraction
  • ROPgadget - ROP/JOP gadget finder with advanced search capabilities
  • Ropper - ROP gadget finder and exploit development tool
  • One-Gadget - Find one-shot RCE gadgets in libc
  • Checksec - Binary security property checker with comprehensive analysis
  • Strings - Extract printable strings from binaries with filtering
  • Objdump - Display object file information with Intel syntax
  • Readelf - ELF file analyzer with detailed header information
  • XXD - Hex dump utility with advanced formatting
  • Hexdump - Hex viewer and editor with customizable output
  • Pwntools - CTF framework and exploit development library
  • Angr - Binary analysis platform with symbolic execution
  • Libc-Database - Libc identification and offset lookup tool
  • Pwninit - Automate binary exploitation setup
  • Volatility - Advanced memory forensics framework
  • MSFVenom - Metasploit payload generator with advanced encoding
  • UPX - Executable packer/unpacker for binary analysis
☁️ Cloud & Container Security (20+ Tools)
  • Prowler - AWS/Azure/GCP security assessment with compliance checks
  • Scout Suite - Multi-cloud security auditing for AWS, Azure, GCP, Alibaba Cloud
  • CloudMapper - AWS network visualization and security analysis
  • Pacu - AWS exploitation framework with comprehensive modules
  • Trivy - Comprehensive vulnerability scanner for containers and IaC
  • Clair - Container vulnerability analysis with detailed CVE reporting
  • Kube-Hunter - Kubernetes penetration testing with active/passive modes
  • Kube-Bench - CIS Kubernetes benchmark checker with remediation
  • Docker Bench Security - Docker security assessment following CIS benchmarks
  • Falco - Runtime security monitoring for containers and Kubernetes
  • Checkov - Infrastructure as code security scanning
  • Terrascan - Infrastructure security scanner with policy-as-code
  • CloudSploit - Cloud security scanning and monitoring
  • AWS CLI - Amazon Web Services command line with security operations
  • Azure CLI - Microsoft Azure command line with security assessment
  • GCloud - Google Cloud Platform command line with security tools
  • Kubectl - Kubernetes command line with security context analysis
  • Helm - Kubernetes package manager with security scanning
  • Istio - Service mesh security analysis and configuration assessment
  • OPA - Policy engine for cloud-native security and compliance
🏆 CTF & Forensics Tools (20+ Tools)
  • Volatility - Advanced memory forensics framework with comprehensive plugins
  • Volatility3 - Next-generation memory forensics with enhanced analysis
  • Foremost - File carving and data recovery with signature-based detection
  • PhotoRec - File recovery software with advanced carving capabilities
  • TestDisk - Disk partition recovery and repair tool
  • Steghide - Steganography detection and extraction with password support
  • Stegsolve - Steganography analysis tool with visual inspection
  • Zsteg - PNG/BMP steganography detection tool
  • Outguess - Universal steganographic tool for JPEG images
  • ExifTool - Metadata reader/writer for various file formats
  • Binwalk - Firmware analysis and reverse engineering with extraction
  • Scalpel - File carving tool with configurable headers and footers
  • Bulk Extractor - Digital forensics tool for extracting features
  • Autopsy - Digital forensics platform with timeline analysis
  • Sleuth Kit - Collection of command-line digital forensics tools

Cryptography & Hash Analysis:

  • John the Ripper - Password cracker with custom rules and advanced modes
  • Hashcat - GPU-accelerated password recovery with 300+ hash types
  • Hash-Identifier - Hash type identification with confidence scoring
  • CyberChef - Web-based analysis toolkit for encoding and encryption
  • Cipher-Identifier - Automatic cipher type detection and analysis
  • Frequency-Analysis - Statistical cryptanalysis for substitution ciphers
  • RSATool - RSA key analysis and common attack implementations
  • FactorDB - Integer factorization database for cryptographic challenges
🔥 Bug Bounty & OSINT Arsenal (20+ Tools)
  • Amass - Advanced subdomain enumeration and OSINT gathering
  • Subfinder - Fast passive subdomain discovery with API integration
  • Hakrawler - Fast web endpoint discovery and crawling
  • HTTPx - Fast and multi-purpose HTTP toolkit with technology detection
  • ParamSpider - Mining parameters from web archives
  • Aquatone - Visual inspection of websites across hosts
  • Subjack - Subdomain takeover vulnerability checker
  • DNSEnum - DNS enumeration script with zone transfer capabilities
  • Fierce - Domain scanner for locating targets with DNS analysis
  • TheHarvester - Email and subdomain harvesting from multiple sources
  • Sherlock - Username investigation across 400+ social networks
  • Social-Analyzer - Social media analysis and OSINT gathering
  • Recon-ng - Web reconnaissance framework with modular architecture
  • Maltego - Link analysis and data mining for OSINT investigations
  • SpiderFoot - OSINT automation with 200+ modules
  • Shodan - Internet-connected device search with advanced filtering
  • Censys - Internet asset discovery with certificate analysis
  • Have I Been Pwned - Breach data analysis and credential exposure
  • Pipl - People search engine integration for identity investigation
  • TruffleHog - Git repository secret scanning with entropy analysis

AI Agents

12+ Specialized AI Agents:

hexstrike-ai (0x4m4/hexstrike-ai)

Searching Database…

这是什么?HexStrike AI MCP Agents 是一个 MCP 服务器,让 Claude、GPT 或 Copilot 等 AI 智能体能够自主运行 150 多种真实的网络安全工具,用于自动化渗透测试、漏洞赏金猎取、CTF 挑战和漏洞发现。
这是我自己运行的应用,还是我的 AI 助手要连接的东西?它是一个本地 MCP(Model Context Protocol,模型上下文协议)服务器:你在自己的机器上启动它,然后让兼容 MCP 的 AI 客户端连接上去,这样 AI 就能真正执行安全工具,而不只是空谈。
我该怎么把它跑起来?先安装所需的安全工具,再启动 HexStrike MCP 服务器,然后通过配置文件让 MCP 客户端(Claude Desktop、Cursor、VS Code Copilot、Roo Code 或 5ire)指向它。
除了服务器本身,我还需要安装什么?你需要自行单独安装底层的安全工具(Nmap、Nuclei、SQLMap、Hashcat、Ghidra 以及数十种其他工具),因为服务器只负责调度这些工具,并不自带它们。
装好就能在任何环境下直接用吗?不能。150 多种工具中的大部分需要你自己安装;另外,对 5ire 最新客户端版本(v0.14.0)的支持目前是坏的。
运行这套工具集必须用 Kali Linux 吗?这套工具集是围绕 Kali Linux 的工具库(Nmap、Amass、Hydra、Volatility 等)构建的,所以实际可行的做法是在 Kali 或配置相近的 Linux 机器上运行,尽管服务器本身只是普通的 Python 程序。
那 12 个以上的 AI 智能体究竟做什么?它们组成一个决策引擎,负责分析目标、挑选合适的工具、自主执行评估,并在发现漏洞时实时调整策略。
它覆盖哪些类别的工具?150 多种工具,涵盖网络侦察、Web 应用测试、密码与认证攻击、二进制文件与逆向工程、云与容器安全、CTF/取证,以及漏洞赏金与 OSINT(开源情报)工作。
它能交互式地测试 Web 应用吗,而不只是运行命令行扫描器?能。它内置一个浏览器智能体,借助无头 Chrome 实现截图、DOM 分析、网络流量监控和实时 JavaScript 执行。
Creator
0x4m4
Size
2.1 MB
Stars
12.9K
Updated
CommitAug 03
Age
1y
Commits · 90 Days