Async launch and fetch for slow scans
Nmap, Nuclei, SQLMap and Gobuster run in the background. Claude launches a scan, gets a process ID right away, keeps working, and fetches results when they're ready. No timeouts, no hung chats.
pentestMCP is an open-source MCP server that hands Claude and other AI agents 40+ real security tools (Nmap, Nuclei, SQLMap, ZAP, Active Directory attacks) inside an isolated Docker container. Plain English in, structured findings out.
Run it in your terminal with Docker running. Using Claude Desktop or VS Code? See other setups.
Every tool is wrapped as an MCP tool with a typed schema, so the model knows what each one does and how to call it. Pick a category to see what's inside.
A pentest agent is only useful if long scans don't freeze the conversation and your laptop stays clean. These are the design decisions that matter.
Nmap, Nuclei, SQLMap and Gobuster run in the background. Claude launches a scan, gets a process ID right away, keeps working, and fetches results when they're ready. No timeouts, no hung chats.
Everything runs in a Docker container as a non-root user. Scanners and exploit tooling stay off your host.
A semaphore caps simultaneous heavy scans so a chatty agent can't melt your machine or the target.
Claude Desktop, Claude Code, VS Code Copilot Chat, or any custom agent that can launch a stdio MCP server.
OWASP ZAP active scans and AJAX spider, plus Kerberoasting, BloodHound collection, DCSync and more for Active Directory work.
"Find subdomains for the target, then scan the live ones for known CVEs."
It reads the tool list from pentestMCP and chooses what to run, with which arguments.
pentestMCP executes the real command-line tools inside the container and returns the output.
Raw output becomes a readable summary, and the next step is one sentence away.
You need Docker running. The image ships with the tools preinstalled, so there's nothing else to set up.
One command registers the server for your user.
$ claude mcp add --scope user pentest-mcp -- docker run --rm -i ramgameer/pentest-mcp:latestAdd this to claude_desktop_config.json, then fully restart Claude Desktop. Look for the hammer icon to confirm the tools loaded.
{
"mcpServers": {
"pentestMCP": {
"command": "docker",
"args": ["run", "--rm", "-i", "ramgameer/pentest-mcp:latest"]
}
}
}Add this server entry to your VS Code MCP settings, then reload the window.
"pentest-mcp": {
"type": "stdio",
"command": "docker",
"args": ["run", "-i", "--rm", "ramgameer/pentest-mcp:latest"]
}Want to build from source? Clone the repo and run docker build. Full steps are in the README.
pentestMCP is built and maintained in the open. A star takes ten seconds and does three real things:
pentestMCP is for education and authorized security assessments. Get explicit written permission before scanning any system you don't own. Unauthorized scanning is illegal, and you are responsible for how you use these tools.