Rekit Documentation
rekit gives a terminal — and any Model Context Protocol (MCP) compatible AI agent — a single safe, deterministic front-end for static binary analysis: file triage, strings, IOC extraction, disassembly, APK/DEX, firmware images, JS bundles, PCAPs and headless Ghidra decompilation. It never executes a sample in memory or on disk, and it never invents a result.
Rekit ships as a lightweight, zero-dependency CLI and high-integrity MCP server:
| Interface | Entrypoint | Install / Run | Guarantees |
|---|---|---|---|
| CLI (Python) | rekit.py |
python3 rekit.py --help |
Pure stdlib, zero-execution sandbox |
| MCP Server | mcp_server.py |
python3 mcp_server.py |
Model Context Protocol (JSON-RPC) |
Key Features
- Strictly Read-Only — only verified analysis binaries (
readelf,objdump,radare2,jadx,tshark, Ghidra headless) are invoked. Samples are never executed. - Nothing Faked — missing system backends explicitly return
{"tool_missing": "..."}. Rekit never hallucinates or guesses. - Machine-Readable Output — every subcommand accepts
--jsonfor direct agent and toolchain ingestion. - Bounded Execution — every subprocess enforces hard timeouts and bounded input size caps via
REKIT_MAX_BYTES.
Quick start in 30 seconds
import json
import subprocess
# Direct triage of binary with clean JSON output
res = subprocess.check_output(["python3", "rekit.py", "triage", "/bin/ls", "--json"])
data = json.loads(res)
print(f"SHA256: {data['sha256']} | Kind: {data['kind']}")
Command line (Python)
# Clone and run stdlib CLI
git clone https://github.com/Amz34/rekit.git && cd rekit
# Fast triage: hashes, file format, sections, entropy, packer detection
python3 rekit.py triage /bin/ls --json
# High-entropy strings and indicators of compromise (IOCs)
python3 rekit.py iocs ./firmware_extracted/sys.img
# Function disassembly & headless Ghidra decompilation to C
python3 rekit.py disasm /bin/ls --func main
python3 rekit.py ghidra /bin/ls --out tiny.decompiled.c
MCP Server Integration
Connect rekit as an autonomous static analysis tool for Claude Desktop, Cursor, or sovereign agent runtimes:
{
"mcpServers": {
"rekit": {
"command": "/usr/bin/python3",
"args": ["/home/ubuntu/projects/rekit-public/mcp_server.py"]
}
}
}
Subcommands
| Subcommand | Description | Backend |
|---|---|---|
triage |
sha256/md5, kind, sections, entropy, packer hints | readelf / objdump / lief |
strings |
strings + interesting filter (URLs, keys, paths, JWTs) | pure Python |
iocs |
extract URLs, IPs, domains, keys, JWTs, wallets, onion addresses | pure Python |
disasm |
disassembly of a function/offset range | radare2 / objdump |
apk |
APK/DEX: manifest, permissions, packer, string surface | jadx / androguard |
firmware |
firmware image signature scan (squashfs, ubifs, uboot, ELF) | binwalk |
js |
JS bundle: endpoints, suspect secrets, obfuscation signals | pure Python |
pcap |
conversations, DNS, HTTP hosts, TLS SNI | tshark |
ghidra |
headless decompile to C (one function or all) | Ghidra analyzeHeadless |
yara |
YARA signature match against rulesets | pure Python / yara |
License
MIT License — see LICENSE for details.