Repository navigation
v0.1.0 — Full Suite
First public release of RedHands — an enterprise-grade MCP server exposing offensive security tools to AI agents.
Highlights
- 23 tools across 7 toolsets (nmap, scan, recon, web, fuzz, exploit, vuln) + system health check
- MCP protocol — JSON-RPC 2.0 over stdio transport, compatible with Claude Code, Cursor, VS Code
- Secure execution — binary allowlist, shell metacharacter rejection, target validation, output caps, execution timeouts
- Rate limiting — token bucket middleware prevents abuse
- Result caching — LRU cache with configurable TTL
- Audit logging — every tool invocation logged as structured JSONL
- Toolset filtering — enable only the tools you need via
REDHANDS_TOOLSETSenv var - Category-based layout — tools organized by domain (scan, recon, web, fuzz, exploit, vuln, system)
Tools Included
| Category | Tools |
|---|---|
| Scan | nmap (4 modes), masscan, rustscan |
| Recon | subfinder, amass, dns/dig, waybackurls, gau, arjun |
| Web | httpx, katana, nikto, whatweb, testssl |
| Fuzz | ffuf, gobuster, feroxbuster |
| Exploit | sqlmap |
| Vuln | nuclei |
| System | health check |
Requirements
- Go 1.26+
- Security tools installed on PATH
Install
go install github.com/yasindce1998/redhands/cmd/redhands@v0.1.0