vmihalis/hacker-bob
View on GitHub ↗A local MCP runtime that attacks what you own and only reports what it proved. 17 CVEs across 9 projects came out of this repo. Install: npx -y hacker-bob@latest install /path/to/project, then run /bob-evaluate target.com
97 ★15 forksJavaScriptUpdated 22d ago
What you need to know
A local offensive-security MCP runtime you install into a project directory and connect to Claude Code, Codex, Kimi CLI, or any MCP host — it coordinates surface mapping, auth setup, parallel testing, finding verification, grading, reporting, and local evidence handling.
Install
npx -y hacker-bob@latest install /path/to/your/project
Usage
- •Install into a dedicated project directory (not the source checkout), then fully restart the host CLI from that directory.
- •Run /bob-evaluate target.com (Claude Code), $bob-evaluate target.com (Codex), or /skill:bob-evaluate target.com (Kimi CLI).
- •Verify integration with /bob-status or hacker-bob doctor /path/to/your/project.
- •Optionally wire up GitHub Actions Bob Diff Review for headless PR security review.
Key features
- ✓Structured workflow: SURFACE_DISCOVERY -> AUTH -> EVALUATE -> CHAIN -> VERIFY -> GRADE -> REPORT.
- ✓Host adapters for Claude Code, Codex, Kimi CLI, and generic MCP hosts; the installer is idempotent and preserves unrelated host config.
- ✓OSS Project Review Mode for testing checked-out repositories with session-scoped Docker replay.
- ✓Local read-only multi-session dashboard (hacker-bob dashboard) on 127.0.0.1:4873.
- ✓GitHub Actions diff review with inline comments, Check Run results, and severity-gated failure (min-severity-for-failure).
Best for
Authorized offensive-security testing (your own code in CI, staging, and authorized live targets) driven by AI agents.
Caveats
- ⚠For authorized testing only — you are responsible for having permission; Bob does not prove authorization, enforce policy, or guarantee containment.
- ⚠Browser auto-signup refuses effective block_internal_hosts; strict local/private DNS blocking is default only in paranoid sessions (--allow-internal-hosts otherwise).
- ⚠Requires Node.js 20+, curl, and python3; surface-discovery tools (subfinder, httpx, nuclei, amass, assetfinder, etc.) are optional but improve coverage.
- ⚠v1.x installs auto-migrate to the canonical 'hacker-bob' server key; legacy ~/bounty-agent-sessions/ roots are not auto-resolved (purge with --purge-legacy-session-root).
- ⚠Read DISCLAIMER.md before use; npm packages publish with provenance.
Platforms: Local · CIClients: Claude Code · Codex · Kimi CLI
Reviewed 2026-08-18
Topics
appsecclaude-codecvefuzzingmcpmodel-context-protocoloffensive-securitypentestingsecuritysmart-contract-security
- Stars
- 97★
- Forks
- 15
- Language
- JavaScript
- License
- Apache-2.0
- Created
- 2026-03-31
- Last push
- 2026-08-13