run_subfinderLABSCO SUMMARY
The pentest toolbox, driven in plain language.
Packing Nmap, Nuclei, ZAP, SQLMap and an Active Directory attack set into one container means an agent can run a whole assessment flow without you juggling installs — and the long scans launch-and-fetch, so they never freeze the session. Two things gate real use: authorization, which the README puts in bold, and ZAP, which you have to run yourself for the web-scanner tools to work.
What it is
An MCP server that exposes a curated suite of security-assessment utilities as callable tools, so an agent in an MCP client can run recon, scanning and exploitation-support tasks by describing them. It runs entirely inside Docker and speaks to the client over stdio, embedding no LLM of its own.
What you get
- Reconnaissance and enumeration: subdomain discovery, DNS lookups, WHOIS, HTTP interaction, OSINT and web crawling —
run_subfinder,run_dig_tool,fetch_whois_data,run_curl_tool,run_harvester,launch_gofang_scan - Network scanning run asynchronously so a long scan does not block the connection —
launch_nmap_scan/fetch_nmap_results,run_gobuster_scan/check_gobuster_status - Template-based vulnerability scanning with Nuclei —
launch_nuclei_scan/fetch_nuclei_results - Web-app analysis and exploitation support: hidden-parameter discovery, Exploit-DB search, and SQL injection testing —
launch_arjun_scan,run_searchsploit,run_sqlmap_tool/check_sqlmap_status - Active Directory enumeration, coercion and credential operations —
ad_user_enum,ad_kerberoast,ad_asreproast,ad_dcsync,ad_secrets_dumpand more - OWASP ZAP active scan and AJAX spider control
Requirements
Docker running on the host. The recommended path is docker pull ramgameer/pentest-mcp:latest; building locally is supported and, per the README, most reliable on Linux. Git is needed only for a local build. ZAP-related tools need a separately running OWASP ZAP instance reachable from inside the container, and the Gobuster/fuzzing tools work best after cloning SecLists. The client launches the server with docker run --rm -i. The pyproject names the package pentest-mcp at 0.1.0. The README's disclaimer is explicit: use only against systems you have written authorization to test — unauthorized scanning is illegal.
Setup effort
One command — docker run --rm -i ramgameer/pentest-mcp:latest
USE CASES
Mapping an authorized target's attack surface
Discover subdomains, then launch an Nmap service scan and fetch the parsed results when it finishes.
Checking a host against known vulnerability templates
Kick off a Nuclei scan and collect its findings asynchronously.
Testing a parameter for SQL injection
Run SQLMap against the endpoint and poll its status until it reports back.
Enumerating an Active Directory domain
List users and shares, then attempt Kerberoasting or AS-REP roasting where the configuration allows it.
35 tools
Listed in project docs. Your client may show a different list.
launch_nmap_scanfetch_nmap_resultsrun_gobuster_scancheck_gobuster_statuslaunch_gofang_scanfetch_gofang_resultsrun_harvestercheck_harvester_statusrun_dig_toolfetch_whois_datarun_curl_toollaunch_nuclei_scanfetch_nuclei_resultslaunch_arjun_scanfetch_arjun_resultsrun_searchsploitrun_sqlmap_toolcheck_sqlmap_statusad_user_enumad_shares_enumad_smb_signing_checkad_certipy_enumad_ldap_dumpad_bloodhound_collectad_asreproastad_kerberoastad_password_sprayad_coerce_petitpotamad_coerce_printerbugad_responder_poisonad_relay_setupad_check_credentialsad_secrets_dumpad_dcsyncBEFORE YOU INSTALL
What to know first
Tools you get
35 tools named in the project's documentation.
Requires
docker on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
docker run --rm -i ramgameer/pentest-mcp:latestMCP Clients
Claude Desktop
{
"mcpServers": {
"pentestMCP": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ramgameer/pentest-mcp:latest"
]
}
}
}VS Code
{
"servers": {
"pentest-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ramgameer/pentest-mcp:latest"
]
}
}
}