Pentest MCP सर्वर | PlugMCP
सामग्री पर जाएँ Pentest MCP Server
A production-ready Model Context Protocol (MCP) server that enables AI agents to perform autonomous penetration testing on ANY Linux distribution via SSH. Built with persistent tmux sessions, intelligent triggers, auto-reconnection, and comprehensive resource management.
MCP server for penetration testing
किसी भी टूल को किसी भी एजेंट से जोड़ें। उन लोगों के लिए MCP निर्देशिका जो सर्वर नहीं लिखते।
उत्पाद
निर्देशिका
डेवलपर्स
कंपनी
🚀 Key Differentiator: Unlike other MCP servers that run commands independently, this server provides persistent session management with tmux, enabling complex interactive workflows and long-running operations.
📋 Table of Contents
👤 Connect
🖼️ Screenshots
🎯 Core Capabilities This MCP server provides AI agents with persistent session control over ANY Linux distribution through SSH, enabling:
🌍 Universal Compatibility : Works with Kali Linux, Parrot Security, BackBox, and ANY Linux distribution
🔓 Zero Tool Limitations : Run ANY tool installed on the target system - no restrictions
🔄 Persistent Sessions : Tmux-based sessions that survive disconnections and crashes
🤖 Intelligent Automation : AI suspension/resumption based on output patterns and triggers
⚡ Auto-Reconnection : Automatic SSH reconnection with exponential backoff
📊 Resource Management : Smart limits on concurrent heavy operations
🎯 Interactive Tools : Full support for msfconsole, mysql, reverse shells, and complex workflows
🛡️ Session Recovery : Recover all sessions after crashes or network issues
🎯 Key Features
Our Core Advantages:
🔄 Session Persistence : Sessions survive disconnections and crashes
🎯 Interactive Tool Support : Handle msfconsole, reverse shells, complex workflows
🤖 Intelligent Automation : AI suspension/resumption with smart triggers
⚡ Auto-Reconnection : Automatic recovery from network issues
📊 Resource Management : Smart limits and system monitoring
🌍 Universal Compatibility : Works with any Linux distribution
💡 The Advantage: Our server provides persistent session management that enables complex, multi-step pentesting workflows with full interactive tool support.
🎯 Real-World Impact
What This Enables:
Complex Workflows : Multi-step pentesting operations that span hours
Interactive Tools : Full Metasploit automation, reverse shell management
Session Persistence : Long-running scans that survive network issues
Resource Management : Smart limits on concurrent operations
Universal Deployment : Works on any Linux distribution
Use Cases:
Red Team Operations : Automated reconnaissance and exploitation
CTF Challenges : Complex multi-step problem solving
Security Research : Long-running vulnerability assessments
AI-Assisted Pentesting : Intelligent automation of repetitive tasks
🏗️ Architecture ┌─────────────────────┐
│ AI Agent │
│ (Claude/ChatGPT) │
└──────────┬──────────┘
│ MCP Protocol
▼
┌─────────────────────┐
│ MCP Server │
│ (Python) │
│ │
│ ┌───────────────┐ │
│ │Session Manager│ │
│ │Auto-Reconnect │ │
│ │Resource Mgmt │ │
│ └───────────────┘ │
└──────────┬──────────┘
│ SSH + PTY
▼
┌─────────────────────┐
│ Pentest System │
│ (Kali/Parrot/etc) │
│ │
│ ┌───────────────┐ │
│ │ tmux │ │
│ │ ┌─────────┐ │ │
│ │ │Session 1│ │ │
│ │ │Session 2│ │ │
│ │ │Session N│ │ │
│ │ └─────────┘ │ │
│ └───────────────┘ │
└─────────────────────┘
🚀 Quick Start
Installation (5 minutes) # 1. Clone repository
git clone https://github.com/LayeSec006/pentest-mcp-server.git
cd pentest-mcp-server
# 2. Install package
pip install -e .
# 3. Configure
cp .env.example .env
# Edit .env with your pentesting os details
# 4. Install tmux on target system
ssh kali@<TARGET_HOST>
# For Debian/Ubuntu/Kali/Parrot:
sudo apt update && sudo apt install tmux
# For Arch/BlackArch:
sudo pacman -S tmux
# For RHEL/CentOS/Fedora:
sudo yum install tmux
# OR for newer versions:
sudo dnf install tmux
# For Alpine Linux:
sudo apk add tmux
exit
# 5. Test
python -m pytest tests/ -v
Configuration Create a .env file with your target system details:
# SSH Connection
TARGET_HOST=192.168.1.100
TARGET_PORT=22
TARGET_USER=kali
TARGET_PASSWORD=your_password
# OR use SSH key instead
# TARGET_SSH_KEY=/path/to/private/key
# Resource Limits
MAX_SESSIONS=20
MAX_HEAVY_TASKS=3
# Monitoring
POLL_INTERVAL=1.0
DEFAULT_TIMEOUT=300
🤖 AI Platform Integration
Claude Desktop Integration Add to your Claude Desktop configuration:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"pentest-mcp": {
"command": "python",
"args": ["-m", "pentest_mcp_server"],
"env": {
"TARGET_HOST": "192.168.1.100",
"TARGET_USER": "kali",
"TARGET_PASSWORD": "your_password"
}
}
}
}
Windsurf Integration Add to your Windsurf settings:
{
"mcpServers": {
"pentest-mcp": {
"command": "python",
"args": ["-m", "pentest_mcp_server"],
"env": {
"TARGET_HOST": "192.168.1.100",
"TARGET_USER": "kali",
"TARGET_PASSWORD": "your_password"
}
}
}
}
Cursor Integration Add to your Cursor settings:
{
"mcpServers": {
"pentest-mcp": {
"command": "python",
"args": ["-m", "pentest_mcp_server"],
"env": {
"TARGET_HOST": "192.168.1.100",
"TARGET_USER": "kali",
"TARGET_PASSWORD": "your_password"
}
}
}
}
5ire Integration
Click on Tools in the main interface
Click the Local button
Fill out the "Edit tool (Local Server)" form:
Tool Key: pentest-mcp
Name: Pentest MCP (optional)
Description: AI-powered penetration testing server (optional)
Approval Policy: Select Always (recommended)
Command: python -m pentest_mcp_server
Environment Variables:
TARGET_HOST = 192.168.1.100
TARGET_USER = kali
TARGET_PASSWORD = your_password
Review the Config Preview to ensure it's correct
Click Save
Enable the tool: Hover over the pentest-mcp entry in the Tools list and click the toggle button that appears on the right to enable it
### Warp AI Integration
In Warp terminal:
1. Go to **Settings** (⌘ + ,)
2. Click on **AI** in the sidebar
3. Scroll down to find **Manage MCP**
4. Click **Add MCP**
5. Paste this JSON configuration:
```json
{
"mcpServers": {
"pentest-mcp": {
"command": "python",
"args": ["-m", "pentest_mcp_server"],
"env": {
"TARGET_HOST": "192.168.1.100",
"TARGET_USER": "kali",
"TARGET_PASSWORD": "your_password"
}
}
}
}
🔧 Quick Setup
Setup Steps # 1. Clone and install
git clone https://github.com/LayeSec006/pentest-mcp-server.git
cd pentest-mcp-server
pip install -e .
# 2. Configure
cp .env.example .env
# Edit .env with your target system details
# 3. Test configuration
python -c "from pentest_mcp_server.config import Config; c = Config(); print('Config loaded:', c.TARGET_HOST)"
🚀 Advanced Capabilities
🎯 Interactive Tool Support Start and interact with complex tools like Metasploit Framework:
{
"tool": "execute",
"args": {
"session_id": "msf_session",
"command": "msfconsole -q"
}
}
Interact with the running tool:
{
"tool": "send_input",
"args": {
"session_id": "msf_session",
"input": "use exploit/multi/handler"
}
}
🔄 Reverse Shell Management Handle incoming reverse shells seamlessly:
{
"tool": "execute",
"args": {
"session_id": "reverse_shell",
"command": "nc -lvp 4444"
}
}
Interact with connected shells:
{
"tool": "send_input",
"args": {
"session_id": "reverse_shell",
"input": "whoami"
}
}
📊 Complex Workflow Automation Support for multi-step pentesting workflows:
Network reconnaissance (nmap, masscan)
Web application scanning (gobuster, nikto, dirb)
Vulnerability exploitation (metasploit, custom exploits)
Post-exploitation (meterpreter, privilege escalation)
Data exfiltration (file operations, tunneling)
🛡️ Session Persistence & Recovery Sessions survive network interruptions and crashes:
{
"tool": "recover_sessions",
"args": {}
}
Sessions continue running even if SSH connection drops
Automatic reconnection with exponential backoff
State preservation across network issues
Full recovery of interactive sessions
🛠️ MCP Tools
Session Management
create_sessionCreate a new persistent tmux session for isolated pentesting operations.
{
"session_id": "scan_network",
"shell": "bash"
}
list_sessionsList all active tmux sessions and their status.
kill_sessionTerminate a specific session and clean up resources.
{
"session_id": "scan_network"
}
Command Execution
executeExecute commands in persistent sessions.
{
"session_id": "scan_network",
"command": "nmap -sV 192.168.1.0/24",
"background": false
}
read_outputGet current output from a session.
{
"session_id": "scan_network",
"lines": 50
}
send_inputSend input to interactive tools.
{
"session_id": "msf_session",
"input": "use exploit/multi/handler",
"press_enter": true
}
System Management
get_system_statusGet system resource usage and session status.
recover_sessionsRecover orphaned sessions after reconnection.
File Operations
upload_fileUpload files to your system via SFTP.
{
"local_path": "/path/to/local/file",
"remote_path": "/tmp/uploaded_file"
}
download_fileDownload files from your system via SFTP.
{
"remote_path": "/tmp/scan_results.xml",
"local_path": "/path/to/local/results.xml"
}
Tool Output Parsing
parse_tool_outputParse common pentest tool outputs (nmap XML, JSON, etc.).
{
"tool": "nmap",
"file_path": "/tmp/scan.xml",
"format": "xml"
}
💡 Usage Examples
Basic Network Scan AI: I need to scan the network 192.168.1.0/24
Tool: create_session
Args: {"session_id": "network_scan"}
Tool: execute
Args: {
"session_id": "network_scan",
"command": "nmap -sV 192.168.1.0/24 -oX /tmp/scan.xml"
}
Tool: read_output
Args: {"session_id": "network_scan"}
Interactive Metasploit Usage AI: Let me start Metasploit and set up a handler
Tool: create_session
Args: {"session_id": "metasploit"}
Tool: execute
Args: {
"session_id": "metasploit",
"command": "msfconsole -q"
}
Tool: send_input
Args: {
"session_id": "metasploit",
"input": "use exploit/multi/handler"
}
Tool: send_input
Args: {
"session_id": "metasploit",
"input": "set PAYLOAD linux/x64/meterpreter/reverse_tcp"
}
Tool: send_input
Args: {
"session_id": "metasploit",
"input": "exploit"
}
Parallel Operations AI: I'll run multiple scans in parallel
Tool: create_session
Args: {"session_id": "nmap_scan"}
Tool: create_session
Args: {"session_id": "gobuster_scan"}
Tool: execute
Args: {
"session_id": "nmap_scan",
"command": "nmap -p- 192.168.1.5",
"background": true
}
Tool: execute
Args: {
"session_id": "gobuster_scan",
"command": "gobuster dir -u http://192.168.1.5 -w /usr/share/wordlists/dirb/common.txt",
"background": true
}
🔒 Security Features
Command Filtering (Optional) The server can optionally block dangerous commands:
rm -rf / - Recursive delete from root
dd if=...of=/dev/sd* - Disk wiping commands
mkfs - Filesystem formatting
Fork bombs and other destructive patterns
🧪 Testing # Install test dependencies
pip install pytest pytest-asyncio pytest-mock
# Run tests
python -m pytest tests/ -v
# Run with coverage
python -m pytest tests/ --cov=pentest_mcp_server --cov-report=html
Test Categories
Unit Tests : Individual component testing
Integration Tests : End-to-end workflow testing
Connection Tests : SSH and reconnection scenarios
Session Tests : Tmux session management
📊 Monitoring & Debugging
Logging The server provides detailed logging:
import logging
logging.basicConfig(level=logging.INFO)
INFO: Connection status, session creation/destruction
WARNING: Reconnection attempts, blocked commands
ERROR: Connection failures, command errors
DEBUG: Detailed protocol messages
System Status Use the get_system_status tool to monitor:
CPU and memory usage
Active session count
Connection health
Recent command history
Session Recovery After crashes or network issues:
Tool: recover_sessions
Args: {}
Response: {
"status": "success",
"recovered_sessions": [
{
"session_id": "network_scan",
"age_seconds": 1800,
"last_output": "...Nmap scan report..."
}
]
}
🔧 Advanced Configuration
Resource Management # Limit concurrent heavy operations
MAX_HEAVY_TASKS=3
# Heavy commands that count against the limit
HEAVY_COMMANDS=nmap,masscan,hydra,john,hashcat,sqlmap
Connection Tuning # Reconnection settings
MAX_RECONNECT_ATTEMPTS=5
RECONNECT_DELAY_BASE=2 # Exponential backoff base
# Health check interval
POLL_INTERVAL=1.0
# Default command timeout
DEFAULT_TIMEOUT=300
Tmux Customization # Custom tmux socket name
TMUX_SOCKET_NAME=mcp-pentest
# Session persistence location
TMUX_SESSION_PATH=/tmp/mcp-sessions
🐛 Troubleshooting
Common Issues Error: Connection failed: [Errno 111] Connection refused
Verify SSH is running on your system: service ssh status
Check firewall rules: ufw status
Verify host/port in configuration
Error: Permission denied (publickey,password)
Verify username/password are correct
Check SSH key permissions (600)
Enable password auth: PasswordAuthentication yes in /etc/ssh/sshd_config
Error: tmux is not installed on target system
Install tmux on your distro: apt update && apt install tmux
Error: Session 'scan_network' does not exist
Use recover_sessions tool to find orphaned sessions
Check if the system rebooted (sessions don't survive reboot)
Debug Mode import logging
logging.getLogger('pentest_mcp_server').setLevel(logging.DEBUG)
logging.getLogger('asyncssh').setLevel(logging.DEBUG)
🤝 Contributing
Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Run tests (python -m pytest tests/)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Open a Pull Request
Development Setup git clone <your-fork>
cd pentest_mcp_server
pip install -e .
pip install pytest pytest-asyncio pytest-mock
📝 License This project is licensed under the MIT License - see the LICENSE file for details.
⚠️ Legal Disclaimer This tool is intended for authorized security testing and educational purposes only. Users are responsible for ensuring they have proper authorization before using this tool against any systems. The developers are not responsible for any misuse or damage caused by this tool.
🙏 Acknowledgments
डायरेक्टरी स्कोर 14/100 सूचीबद्ध 10 में से 10
आधिकारिक MCP Registry में 18 में से 0
मेंटेनर द्वारा क्लेम किया गया 8 में से 0
टूल सूची के साथ जवाब देता है 12 में से 0
GitHub स्टार 16 में से 8
साप्ताहिक डाउनलोड 10 में से 0
Worldmonitor Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface Strix Open-source AI penetration testing tool to find and fix your app’s vulnerabilities. MCP For Beginners This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for Casdoor An open-source Agent-first Identity and Access Management (IAM) /LLM MCP & agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Ida Pro AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP. NPM Sentinel MCP Provide AI-powered real-time analysis and intelligence on NPM packages, including security, dependencies, performance, and quality metrics. Enable faster and safer package management decisions by inte Ida Pro AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP. Hexstrike Ai HexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomously run 150+ cybersecurity tools for automated pentesting, vulnerability discovery, bug boun Nist Nvd Search and audit NIST NVD CVEs by keyword, severity, CWE, CISA KEV status, and CPE. GhidraMCP MCP Server for Ghidra GhidraMCP MCP Server for Ghidra ComplianceCheckup Free automated privacy grades (A+ to F) for 900+ SaaS tools, plus GDPR, HIPAA, PCI DSS, SOC 2, CCPA, and ADA compliance checklists with source citations. Security MCP सर्वर सबसे अच्छे Security MCP सर्वर
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
Pentest कैसे इंस्टॉल करें? इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
क्या Pentest के लिए API key चाहिए? इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Pentest कौन सा ट्रांसपोर्ट इस्तेमाल करता है? Pentest stdio पर लोकल चलता है।
Pentest की पिछली जाँच कब हुई थी? पिछली जाँच 2026-10-27 को हुई। MCP server for penetration testing
टूल के विवरण मौजूद हैं 6 में से 0
वॉइस के लिए तैयार 3 में से 0