DarkDriftz/Kali-Linux-Bleeding-Edge-MCP-Server
1
๐ฅ DarkDriftz's Unified Bleeding Edge Kali Linux MCP Server
Version 4.0.0 - Complete Platform with Linux Sandbox & PowerShell Integration
Hugging Face Spaces + HuggingChat MCP Integration with Full Feature Parity
๐ NEW IN VERSION 4.0.0
๐ง Linux Sandbox Execution Environment
Secure, isolated execution environment for running security tools safely with:
- Namespace Isolation: User, PID, and Network namespace separation
- Resource Limits: CPU, memory, and process restrictions
- Whitelisted Tools: 30+ pre-approved security tools
- Session Management: Create, manage, and destroy sandbox sessions
- Automatic Cleanup: Session directories are purged on destruction
โก PowerShell Core Integration
Cross-platform security automation with systemd service support:
- 5 Security Scripts: Vulnerability scanning, port scanning, network auditing, log analysis, compliance checking
- Systemd Service: Generate production-ready systemd unit files
- Resource Management: CPU and memory limits for script execution
- Cross-Platform: Works on Windows, Linux, and macOS
๐ก๏ธ REVOLUTIONARY PLATFORM FEATURES
- โ 793+ Cybersecurity Tools: Complete arsenal with bleeding edge enhancement
- โ 150 Bleeding Edge Tools: Experimental security tools from dev repositories
- โ Linux Sandbox: Secure isolated execution environment
- โ PowerShell Integration: Cross-platform security automation
- โ Unified Implementation: Single codebase for Gradio + MCP integration
- โ Complete Feature Parity: Identical capabilities across all interfaces
- โ MCP Protocol Compliance: Full MCP 2024-11-05 standard implementation
- โ Real-time SSE Transport: Live communication with HuggingChat and MCP clients
๐ง LINUX SANDBOX FEATURES
Sandbox Capabilities
SANDBOX_CONFIG = {
"enabled": True,
"default_timeout": 300, # 5 minutes
"max_timeout": 3600, # 1 hour
"resource_limits": {
"max_memory_mb": 512,
"max_cpu_percent": 50,
"max_processes": 20,
"max_file_size_mb": 100
},
"security": {
"user_namespace": True,
"pid_namespace": True,
"network_namespace": True,
"no_new_privileges": True
}
}Allowed Tools in Sandbox
nmap, nikto, dirb, gobuster, sqlmap, wpscan, hydra, john, hashcat,
aircrack-ng, wireshark-cli, tcpdump, netcat, curl, wget, whois, dig,
nslookup, traceroute, ping, arp-scan, masscan, enum4linux, smbclient,
rpcclient, crackmapexec, impacket-scriptsUsage Example
# Create sandbox session
session_id = sandbox_executor.create_session()
# Execute command in sandbox
result = await sandbox_executor.execute_command(
session_id=session_id,
command="nmap -sV -p 1-1000 localhost",
timeout=300
)
# Destroy session when done
sandbox_executor.destroy_session(session_id)โก POWERSHELL INTEGRATION FEATURES
Security Scripts
Systemd Service Integration
Generate production-ready systemd unit files for PowerShell services:
[Unit]
Description=DarkDriftz PowerShell Security Service
After=network.target
[Service]
Type=simple
User=pwsh-worker
ExecStart=/usr/bin/pwsh -NoProfile -NoExit -Command "Start-Sleep -Seconds 86400"
Restart=on-failure
# Security hardening
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
# Resource limits
MemoryMax=1024M
CPUQuota=75%
[Install]
WantedBy=multi-user.targetUsage Example
# Execute security script
result = await powershell_engine.execute_script("""
Invoke-NetworkAudit -IncludeServices
""")
# Generate systemd unit
unit_file = powershell_engine.generate_systemd_unit()๐ก MCP INTEGRATION FEATURES
Available MCP Tools (7 Functions)
- get_complete_kali_arsenal_info: Complete arsenal overview with sandbox/PowerShell status
- get_kali_tool_category: Detailed category information
- run_kali_security_scan: Bleeding edge security scanning
- get_bleeding_edge_status: Repository status and capabilities
- generate_kali_security_report: Professional security reporting
- execute_sandbox_command: Execute commands in Linux sandbox
- execute_powershell_script: Run PowerShell security scripts
HuggingChat Integration
// Add MCP server to HuggingChat
await client.addMcpServer({
type: "sse",
url: "https://your-space.hf.space/gradio_api/mcp/sse",
name: "DarkDriftz Bleeding Edge Kali"
});
// Execute sandbox command
const scanResult = await client.callTool("execute_sandbox_command", {
command: "nmap -sV localhost"
});
// Run PowerShell compliance check
const compliance = await client.callTool("execute_powershell_script", {
script_name: "Invoke-ComplianceCheck",
parameters: "-Framework CIS"
});๐ DEPLOYMENT GUIDE
HuggingFace Spaces Deployment
# 1. Create new Space on Hugging Face Hub
# 2. Upload these files:
app.py # Main application
requirements.txt # Dependencies
README.md # This file
# 3. Configure Space settings:
# SDK: gradio
# SDK Version: 6.0.2
# Python version: 3.11+
# Hardware: CPU Basic (recommended)
# 4. Space auto-deploys with:
# - Gradio interface at: https://your-space.hf.space
# - MCP SSE endpoint: https://your-space.hf.space/gradio_api/mcp/sse
# - Health check: https://your-space.hf.space/healthLocal Development
# Install dependencies
pip install -r requirements.txt
# Install PowerShell Core (optional, for PowerShell features)
# Ubuntu/Debian:
sudo apt-get install powershell
# Run server
python app.py
# Access points:
# Gradio interface: http://localhost:7860
# MCP SSE endpoint: http://localhost:7860/gradio_api/mcp/sseDocker Deployment
FROM python:3.11-slim
# Install PowerShell Core
RUN apt-get update && apt-get install -y wget apt-transport-https software-properties-common
RUN wget -q https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb
RUN dpkg -i packages-microsoft-prod.deb
RUN apt-get update && apt-get install -y powershell
WORKDIR /app
COPY . .
RUN pip install -r requirements.txt
EXPOSE 7860
CMD ["python", "app.py"]๐ก๏ธ COMPLETE CYBERSECURITY ARSENAL
Arsenal Statistics
- Standard Kali Tools: 643 from 13 specialized categories
- Bleeding Edge Tools: 150 experimental security tools
- Total Arsenal: 793 cybersecurity tools
- MCP Tools: 7 comprehensive cybersecurity functions
- Sandbox Tools: 30+ whitelisted security tools
- PowerShell Scripts: 5 security automation scripts
Security Categories (All Bleeding Edge Enhanced)
- Information Gathering (85 tools) - Advanced reconnaissance and OSINT
- Vulnerability Analysis (62 tools) - AI-powered vulnerability scanning
- Web Applications (58 tools) - Modern web security testing
- Password Attacks (42 tools) - Next-generation cracking tools
- Wireless Attacks (38 tools) - Advanced wireless security testing
- Exploitation Tools (55 tools) - Latest exploitation frameworks
- Forensics (48 tools) - Advanced digital forensics
- Reverse Engineering (35 tools) - Complete analysis toolkit
- Hardware Hacking (28 tools) - IoT and hardware security
- Crypto & Stego (32 tools) - Cryptography and steganography
- Reporting Tools (25 tools) - Professional security reporting
- Social Engineering (22 tools) - OSINT and social engineering
- Sniffing & Spoofing (31 tools) - Network analysis and manipulation
๐ฅ BLEEDING EDGE FEATURES
Experimental Capabilities
- AI-Powered Security Analysis: Neural network threat detection
- Quantum-Resistant Cryptography: Post-quantum security testing
- Zero-Day Research Tools: Latest vulnerability discovery frameworks
- Advanced Fuzzing: Machine learning guided input generation
- Sandbox Execution: Isolated security tool testing
- PowerShell Automation: Cross-platform security scripting
Auto-Update System
- Frequency: Every 4 hours bleeding edge repository sync
- Monitoring: Continuous experimental tool availability checking
- Priority: High-priority access to latest security tools
- Fallback: Automatic rollback on update failures
๐ก๏ธ ETHICAL USE GUIDELINES
โ AUTHORIZED USES
- Penetration Testing: Authorized security assessments
- Security Research: Academic and professional cybersecurity research
- Education: Cybersecurity training and certification programs
- Compliance: Regulatory security requirement validation
- Incident Response: Digital forensics and threat analysis
โ PROHIBITED USES
- Unauthorized Access: Testing systems without explicit permission
- Malicious Attacks: Any illegal or harmful activities
- Data Theft: Unauthorized data access or exfiltration
- System Damage: Intentional disruption of services or systems
- Privacy Violation: Unauthorized monitoring or surveillance
โก QUICK START EXAMPLES
Sandbox Execution
# Via MCP
result = await client.callTool("execute_sandbox_command", {
"command": "nmap -sV -p 22,80,443 target.com"
});
# Via Gradio interface
# 1. Go to "Linux Sandbox" tab
# 2. Click "Create Session"
# 3. Enter command and click "Execute"PowerShell Security Scripts
# Via MCP
result = await client.callTool("execute_powershell_script", {
"script_name": "Invoke-VulnerabilityScan",
"parameters": "-Target example.com -ScanType Quick"
});
# Via Gradio interface
# 1. Go to "PowerShell Integration" tab
# 2. Select script from dropdown
# 3. Enter parameters and click "Execute"๐ PLATFORM SUMMARY
DarkDriftz's Unified Bleeding Edge Kali Linux MCP Server v4.0.0 represents the pinnacle of cybersecurity research platform development with:
๐ฏ Key Achievements
- โ Complete Unification: Single codebase for multiple access methods
- โ Feature Parity: Identical capabilities across all interfaces
- โ Linux Sandbox: Secure isolated execution environment
- โ PowerShell Integration: Cross-platform security automation
- โ Bleeding Edge: 150 experimental tools with continuous updates
- โ MCP Compliance: Full protocol implementation with SSE transport
- โ Professional Quality: Enterprise-grade security research platform
๐ Platform Impact
This unified implementation sets a new standard for cybersecurity research platforms by combining:
- Advanced tool integration with bleeding edge enhancement
- Secure sandbox execution for safe tool testing
- PowerShell automation for cross-platform security scripting
- Complete MCP protocol compliance for AI integration
- Unified architecture for consistent user experience
๐ฅ DarkDriftz - Pushing the Boundaries of Cybersecurity Research Excellence
๐ SUPPORT
- Platform Issues: Check HuggingFace Spaces logs
- Tool Questions: Refer to individual tool documentation
- MCP Integration: See MCP Protocol documentation
- Feature Requests: Open an issue on the repository
Created by DarkDriftz | Version 4.0.0 | December 2025
