PepperSpray-MCP
Optional third-party API key integration that unlocks VirusTotal enrichment for security assessment and vulnerability analysis data.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
PepperSpray-MCP
A Model Context Protocol (MCP) server that puts a penetration-testing toolkit behind an AI assistant. It exposes reconnaissance, scanning, and vulnerability analysis tooling as MCP tools, so a client like Claude can drive a security assessment conversationally while the heavy lifting runs inside a sandboxed Docker container.
⚠️ Authorized use only
This project is for authorized security testing, research, and education. Only run it against systems you own or have explicit written permission to test. Unauthorized scanning or exploitation is illegal in most jurisdictions. You are solely responsible for how you use it. Provided as-is, with no warranty.
Architecture
MCP client (Claude)
│ stdio
▼
mcp-pepperspray-wrapper.sh ──► tcp_stdio_bridge.py ──► TCP
│
▼
pepperspray_server.py (Docker)
├─ tool registry & execution
├─ recon / scanning modules
└─ vulnerability analysispepperspray_server.py: the core server that registers and executes the toolingpepperspray_mcp.py: MCP protocol handlers and tool definitionstcp_stdio_bridge.py: bridges the MCP client's stdio to the container's TCP socketmcp-pepperspray-wrapper.sh: thin launcher the MCP client invokes
Related MCP server: Hercules MCP
Requirements
Docker + Docker Compose
socatfor the stdio to TCP bridge (brew install socat)
Quick start
git clone <repository> pepperspray-mcp && cd pepperspray-mcp
cp .env.example .env
docker compose up -d --buildRegister it with Claude Code:
claude mcp add pepperspray -- bash -c "/absolute/path/to/mcp-pepperspray-wrapper.sh"
claude mcp list # verify it connectedOr add it to any MCP client config manually:
{
"mcpServers": {
"pepperspray": {
"command": "bash",
"args": ["-c", "/absolute/path/to/mcp-pepperspray-wrapper.sh"],
"timeout": 300
}
}
}Configuration
Copy .env.example to .env. Core settings (ports, host, timeouts) work out of
the box. Optional third-party API keys (Shodan, Censys, VirusTotal) unlock
additional enrichment when provided.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
Secure Linux sandboxes for AI agents, as MCP tools.
The main MCP server has 10 tools, including six public, read-only CVE tools, site search and page reading. CVE results include source software/version evidence and available CISA KEV and dated FIRST EPSS data. The separate request_security_test action requires an agent key, consent and authorization. A no-account, read-only CVE-only endpoint is https://excessionlabs.ai/mcp/cve. Docs: https://excessionlabs.ai/cve-intelligence/.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables LLMs to execute common security testing tools like nmap, sqlmap, hydra, and metasploit through a secure Docker container. Provides controlled access to penetration testing utilities with configurable timeouts and tool discovery capabilities.-
- AlicenseAqualityBmaintenanceEnables AI agents to perform professional penetration testing through a containerized Kali Linux environment, exposing industry-standard offensive security tools as structured MCP tools.455MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to autonomously execute over 200 open-source penetration testing tools via MCP, including reconnaissance, web exploitation, and brute-forcing, through a unified server architecture with Docker sandboxing for safe execution.60MIT
- AlicenseBqualityCmaintenanceMCP server for offensive-security tooling, enabling AI agents to run reconnaissance, CVE intelligence, JavaScript analysis, HTTP probing, and port scanning against authorized targets.10MIT