john-the-ripper-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| JOHN_PATH | No | Path to john binary on remote system | john |
| JOHN_SSH_HOST | Yes | SSH hostname or IP of Kali system | kali |
| JOHN_SSH_USER | No | SSH username (optional) | |
| JOHN_WORK_DIR | No | Remote working directory for temp files | /tmp/john-mcp |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| john_crackA | Start password cracking with John the Ripper. Supports various modes including wordlist, incremental, and single crack. |
| john_showC | Show cracked passwords from a hash file or pot file |
| john_statusB | Check the status of a cracking session |
| john_restoreA | Restore and continue an interrupted cracking session |
| john_formatsA | List all supported hash formats. Can filter by keyword. |
| john_identifyB | Identify the hash type(s) for given hash values |
| john_rulesB | List available mangling rules or test rules against words |
| john_benchmarkA | Run benchmarks to test cracking speed for different hash types |
| john_potC | Manage the john.pot file containing cracked passwords |
| john_hash_extractA | Extract hashes from various file types using John's *2john utilities |
| john_sessionsA | List all active and saved John the Ripper sessions |
| john_killB | Kill a running John the Ripper process or session |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools have distinct purposes, but john_status and john_sessions could overlap since both deal with session information, and john_show and john_pot both relate to cracked passwords. However, descriptions clarify the specific roles, so confusion is minimal.
All tool names follow a consistent john_ prefix followed by a verb-noun combination (e.g., john_crack, john_show, john_hash_extract). The snake_case style is uniform, making the naming predictable and readable.
12 tools is well within the ideal range for a specialized utility. Each tool addresses a distinct aspect of John the Ripper's workflow, and there is no bloat or unnecessary duplication.
The tool set covers the full lifecycle of password cracking: hash extraction, identification, format listing, cracking, monitoring/restoring, showing results, pot management, benchmarking, rules, and session control. No obvious gaps for the domain.