Open-source reverse engineering lab — 197-article knowledge base, 100+ MCP automation tools, covering CTF pentesting / APK reverse engineering / PE binary analysis / cryptography & protocol cracking / game cheating analysis. Agent-native, directory-as-convention.
Routing
Signal → kb_router(board=) → kb_read_file → Attack chain → MCP tool mapping → Execution
| Signal Type | Board | KB Categories / Files | MCP Tool Family |
|---|---|---|---|
| HTTP/Web/API/CVE/CAPTCHA | ctf-website |
23/97 | http_probe run_ctf_tool kb_router |
| APK/DEX/SO/Frida/Java | apk-reverse |
8/17 | android_app_baseline android_crypto_unpack_recipe android_frida_* |
| PE/x64/x86/malware/driver | pe-reverse |
8/18 | triage_pe ghidra_headless_analyze make_x64dbg_breakpoint_script sample_full_workup |
| Crypto/Protocol/Cheat/IoT/Radio | general |
4+4/12 | die_scan ghidra_* rizin_* python_re_tool_* |
Knowledge Base
kb/
├── ctf-website/techniques/ 23 categories, 97 articles — Full web attack surface
├── apk-reverse/techniques/ 8 categories, 17 articles — APK/DEX reverse engineering
├── pe-reverse/techniques/ 8 categories, 18 articles — PE binary analysis
└── general/techniques/ 4+4 categories, 12 articles — Cryptography / Protocols / Cheating / Methodology
Each technique file follows this structure: Scenario → Input signal → Method → Attack chain → MCP tool mapping
Agent workflow: detect signal → kb_router lookup → kb_read_file → execute via MCP tool mapping.
Boards
| Board | Trigger Signals |
|---|---|
boards/ctf-website |
URL, HTTP, JWT, SQLi, SSRF, CVE, API, CSP, OAuth, CAPTCHA, Cloudflare, ReDoS, Slowloris, DoS, Paywall |
boards/android |
APK, DEX, adb, Frida, jadx, smali, SO, native |
boards/windows |
PE, EXE, DLL, x64dbg, Ghidra, Procmon, packer, malware |
boards/general |
AES/DES/RSA, protobuf, game cheat, EAC/BE/Vanguard, firmware, JTAG, SDR |
boards/misc |
MCP config, skill installation, environment health check |
Directory Convention
samples/ → Original samples + _quarantine/ + unpacked/
exports/ → Tool outputs (triage / IOC / YARA / Sigma / Procmon / Ghidra summaries)
patches/ → Patch artifacts (original samples are never modified)
notes/ → Analysis notes
reports/ → Final reports
scripts/ → Automation scripts
projects/ → Ghidra project files
templates/ → Note / report / rule templates
kb/ → Reusable attack knowledge base
tools/ → Toolchain
cases/ → Lightweight index — no large file copies
Installation
git clone https://github.com/LING71671/open-reverselab.git
cd open-reverselab
.\scripts\misc\bootstrap.ps1 # Core script wrappers (no downloads)
.\scripts\misc\install_tools.ps1 -CTF # Web tools
.\scripts\misc\install_tools.ps1 -Android # APK tools
.\scripts\misc\install_tools.ps1 -Windows # PE tools
.\scripts\misc\install_tools.ps1 -Common # Ghidra + Maven
Post-install verification:
python scripts/misc/lab_healthcheck.py
python scripts/misc/ai_toolcheck.py --board misc
python scripts/misc/public_release_check.py
--board misc verifies the fresh-clone core Agent scripts and lightweight tools. Run the full python scripts/misc/ai_toolcheck.py only after installing the Android, Windows, and CTF board toolchains you need.
Context Chain
On startup the Agent loads context along this chain:
CLAUDE.md → AGENTS.md → AI-USAGE.md → boards/<board>/AI-USAGE.md
Pair with codex-session-patcher for one-click project-level .codex/ environment and MCP server configuration.
Comments