Cyber Master MCP Server v1.0

AI-Powered Cybersecurity Automation Platform

155 Security Tools | AI-Powered | MCP Compatible

What is This?
Features
System Requirements
Installation
Setup Guide
How to Use
Available Tools
Configuration
Troubleshooting
FAQ

What is This?

Cyber Master MCP Server is a complete cybersecurity toolkit that works with AI assistants like Claude, ChatGPT, or VS Code Copilot. It provides 155+ security tools that you can control through natural language.

Example:

You: "Scan example.com for open ports"
AI: Uses nmap_scan tool to scan the target
You: "Check for SQL injection vulnerabilities"
AI: Uses sqlmap_scan tool to test the target

Features

155 Security Tools - Network, web, cloud, binary analysis
AI Integration - Works with Claude Desktop, VS Code Copilot, Cursor
Website Cloner - Clone websites with anti-detection
Bug Bounty Workflows - Automated recon and testing
Real-time Monitoring - Live process dashboard
Smart Caching - Faster repeated scans
Error Recovery - Automatic retry and fallback

System Requirements

Minimum Requirements

OS: Linux (Ubuntu 20.04+), macOS 12+, or Windows 10+
RAM: 8GB minimum (16GB recommended)
Storage: 10GB free space
Python: 3.8 or higher
Internet: Required for tool downloads and scanning

Installation

Step 1: Clone the Repository

hljs language-bash

# Open terminal and navigate to desired location
cd ~/Desktop

# Clone the repository
git clone https://github.com/your-username/cyber-master.git

# Enter the directory
cd cyber-master

Step 2: Create Virtual Environment

hljs language-bash

# Create virtual environment
python3 -m venv cyber-env

# Activate it (Linux/Mac)
source cyber-env/bin/activate

# Activate it (Windows)
# cyber-env\Scripts\activate

Step 3: Install Dependencies

hljs language-bash

# Install Python packages
pip install -r requirements.txt

Step 4: Install Security Tools

hljs language-bash

# On Kali Linux (most tools pre-installed)
sudo apt update && sudo apt install -y \
  nmap masscan rustscan amass subfinder nuclei nikto \
  gobuster feroxbuster ffuf dirb dirsearch httpx katana \
  sqlmap wpscan hydra john hashcat ghidra radare2 gdb \
  binwalk volatility3 prowler trivy

# On Ubuntu/Debian
sudo apt update && sudo apt install -y nmap nikto sqlmap hydra

Step 5: Verify Installation

hljs language-bash

# Check if tools are installed
which nmap
which nuclei
which gobuster

# Should return paths like /usr/bin/nmap

Setup Guide

Step 1: Start the Server

hljs language-bash

# Make sure virtual environment is activated
source cyber-env/bin/activate

# Start the MCP server
python3 cyber_master_server.py

# You should see:
# ✅ CyberMaster AI MCP Server Started
# 📊 Port: 8888

Step 2: Test Server Health

hljs language-bash

# Open new terminal and test
curl http://localhost:8888/health

# Should return JSON with server status

Step 3: Configure AI Client

For Claude Desktop:

Open Claude Desktop
Go to Settings > MCP Servers
Add new server with this config:

hljs language-json

{
  "mcpServers": {
    "cyber-master": {
      "command": "python3",
      "args": [
        "/full/path/to/cyber-master/cyber_master_mcp.py",
        "--server",
        "http://localhost:8888"
      ],
      "timeout": 300
    }
  }
}

For VS Code Copilot:

Open VS Code
Go to Settings (Ctrl+,)
Search for "MCP"
Add server configuration:

hljs language-json

{
  "servers": {
    "cyber-master": {
      "type": "stdio",
      "command": "python3",
      "args": [
        "/full/path/to/cyber-master/cyber_master_mcp.py",
        "--server",
        "http://localhost:8888"
      ]
    }
  }
}

Step 4: Restart AI Client

Close and reopen your AI client (Claude Desktop or VS Code).

Step 5: Verify Connection

Ask your AI assistant:

hljs language-arduino

"Can you check the health of the Cyber Master server?"

If connected, it will use the server_health tool.

How to Use

Basic Usage

Start the server:

hljs language-bash

cd cyber-master
source cyber-env/bin/activate
python3 cyber_master_server.py

Open your AI assistant (Claude Desktop, VS Code Copilot, etc.)
Start asking questions:

Example Commands

Network Scanning

hljs language-arduino

"Scan 192.168.1.1 for open ports using nmap"
"Run a comprehensive scan on example.com"
"Do a quick port scan on 10.0.0.1"

Web Application Testing

hljs language-arduino

"Check example.com for SQL injection vulnerabilities"
"Scan for XSS vulnerabilities on target.com"
"Find hidden directories on website.com"
"Test for command injection on api.target.com"

Vulnerability Assessment

hljs language-arduino

"Run a vulnerability scan on target.com using nuclei"
"Check for common misconfigurations on server.com"
"Scan for known CVEs in the target system"

Website Cloning

hljs language-arduino

"Clone the website example.com with all assets"
"Create a phishing simulation of login.example.com"
"Clone target.com with depth 2 and download assets"

Bug Bounty Workflow

hljs language-arduino

"Start a bug bounty recon workflow for target.com"
"Find all subdomains of example.com"
"Enumerate parameters on api.target.com"

Binary Analysis

hljs language-arduino

"Analyze this binary file for vulnerabilities"
"Check if this ELF binary has security protections"
"Find ROP gadgets in this binary"

Cloud Security

hljs language-arduino

"Audit my AWS account for security issues"
"Scan my Kubernetes cluster for vulnerabilities"
"Check my Docker images for CVEs"

Available Tools

Network Tools (25+)

nmap_scan() - Port scanning
rustscan_fast_scan() - Ultra-fast port scanning
masscan_high_speed() - High-speed port scanning
autorecon_comprehensive() - Full reconnaissance
amass_scan() - Subdomain enumeration

Web Tools (40+)

nuclei_scan() - Vulnerability scanning
nikto_scan() - Web server scanning
sqlmap_scan() - SQL injection testing
gobuster_scan() - Directory enumeration
ffuf_scan() - Web fuzzing
wpscan_analyze() - WordPress scanning

Binary Tools (25+)

ghidra_analysis() - Reverse engineering
radare2_analyze() - Binary analysis
gdb_peda_debug() - Debugging
checksec_analyze() - Security checks

Cloud Tools (20+)

prowler_scan() - AWS security
trivy_scan() - Container scanning
kube_hunter_scan() - Kubernetes testing

Bug Bounty Tools (20+)

bugbounty_reconnaissance_workflow() - Full recon
bugbounty_vulnerability_hunting() - Vuln hunting
bugbounty_osint_gathering() - OSINT collection

Configuration

Server Configuration

Edit cyber-master-mcp.json:

hljs language-json

{
  "mcpServers": {
    "cyber-master": {
      "command": "python3",
      "args": [
        "/path/to/cyber_master_mcp.py",
        "--server",
        "http://localhost:8888"
      ],
      "timeout": 300
    }
  }
}

Server Options

hljs language-bash

# Start on different port
python3 cyber_master_server.py --port 9000

# Start with debug mode
python3 cyber_master_server.py --debug

# Start with both
python3 cyber_master_server.py --port 9000 --debug

Environment Variables

hljs language-bash

# Set custom port
export CYBERMASTER_PORT=9000

# Set custom host
export CYBERMASTER_HOST=0.0.0.0

# Set log level
export CYBERMASTER_LOG=DEBUG

Troubleshooting

Problem: Server Won't Start

Solution:

hljs language-bash

# Check Python version
python3 --version

# Should be 3.8 or higher

# Check if port is in use
netstat -tlnp | grep 8888

# Kill existing process if needed
kill -9 <PID>

Problem: Tools Not Found

Solution:

hljs language-bash

# Check if tool is installed
which nmap

# Install missing tools
sudo apt install nmap

# Check PATH
echo $PATH

Problem: AI Client Can't Connect

Solution:

Verify server is running:
hljs language-bash
```
curl http://localhost:8888/health
```
Check MCP configuration path is correct
Restart AI client
Check server logs for errors

Problem: Permission Denied

Solution:

hljs language-bash

# Make scripts executable
chmod +x cyber_master_server.py
chmod +x cyber_master_mcp.py

# Check file permissions
ls -la

Problem: Slow Performance

Solution:

hljs language-bash

# Use faster scanning profile
python3 cyber_master_server.py --debug

# Check system resources
htop

# Reduce concurrent scans
# Edit server config to limit threads

FAQ

Q: Can I use this on Windows?

A: Yes, but Kali Linux is recommended for full functionality. On Windows, use WSL2.

Q: Do I need to install all 155 tools?

A: No. Start with core tools (nmap, nuclei, gobuster). Install others as needed.

Q: Is this legal?

A: Only use on systems you own or have written permission to test. Unauthorized testing is illegal.

Q: Can I run this without AI?

A: Yes. You can use the Python API directly. See the code examples in the source.

Q: How do I update?

hljs language-bash

cd cyber-master
git pull
pip install -r requirements.txt

Q: Can I contribute?

A: Yes! Fork the repository and submit a pull request.

Safety Notice

⚠️ IMPORTANT:

Only use on systems you own or have authorization to test
Unauthorized scanning is illegal and unethical
Always get written permission before testing
Use in isolated lab environments for learning
Follow responsible disclosure for any vulnerabilities found

Support

Author: Nikhil Gupta
Email: nikhilguptaji8@gmail.com

License

This project is for educational and authorized security testing purposes only.

Made with ❤️ by Nikhil Gupta for AI-powered security automation

Cyber Master MCP Server v1.0

AI-Powered Cybersecurity Automation Platform

155 Security Tools | AI-Powered | MCP Compatible

What is This?
Features
System Requirements
Installation
Setup Guide
How to Use
Available Tools
Configuration
Troubleshooting
FAQ

What is This?

Example:

You: "Scan example.com for open ports"
AI: Uses nmap_scan tool to scan the target
You: "Check for SQL injection vulnerabilities"
AI: Uses sqlmap_scan tool to test the target

Features

155 Security Tools - Network, web, cloud, binary analysis
AI Integration - Works with Claude Desktop, VS Code Copilot, Cursor
Website Cloner - Clone websites with anti-detection
Bug Bounty Workflows - Automated recon and testing
Real-time Monitoring - Live process dashboard
Smart Caching - Faster repeated scans
Error Recovery - Automatic retry and fallback

System Requirements

Minimum Requirements

OS: Linux (Ubuntu 20.04+), macOS 12+, or Windows 10+
RAM: 8GB minimum (16GB recommended)
Storage: 10GB free space
Python: 3.8 or higher
Internet: Required for tool downloads and scanning

Installation

Step 1: Clone the Repository

hljs language-bash

# Open terminal and navigate to desired location
cd ~/Desktop

# Clone the repository
git clone https://github.com/your-username/cyber-master.git

# Enter the directory
cd cyber-master

Step 2: Create Virtual Environment

hljs language-bash

# Create virtual environment
python3 -m venv cyber-env

# Activate it (Linux/Mac)
source cyber-env/bin/activate

# Activate it (Windows)
# cyber-env\Scripts\activate

Step 3: Install Dependencies

hljs language-bash

# Install Python packages
pip install -r requirements.txt

Step 4: Install Security Tools

hljs language-bash

# On Kali Linux (most tools pre-installed)
sudo apt update && sudo apt install -y \
  nmap masscan rustscan amass subfinder nuclei nikto \
  gobuster feroxbuster ffuf dirb dirsearch httpx katana \
  sqlmap wpscan hydra john hashcat ghidra radare2 gdb \
  binwalk volatility3 prowler trivy

# On Ubuntu/Debian
sudo apt update && sudo apt install -y nmap nikto sqlmap hydra

Step 5: Verify Installation

hljs language-bash

# Check if tools are installed
which nmap
which nuclei
which gobuster

# Should return paths like /usr/bin/nmap

Setup Guide

Step 1: Start the Server

hljs language-bash

# Make sure virtual environment is activated
source cyber-env/bin/activate

# Start the MCP server
python3 cyber_master_server.py

# You should see:
# ✅ CyberMaster AI MCP Server Started
# 📊 Port: 8888

Step 2: Test Server Health

hljs language-bash

# Open new terminal and test
curl http://localhost:8888/health

# Should return JSON with server status

Step 3: Configure AI Client

For Claude Desktop:

Open Claude Desktop
Go to Settings > MCP Servers
Add new server with this config:

hljs language-json

{
  "mcpServers": {
    "cyber-master": {
      "command": "python3",
      "args": [
        "/full/path/to/cyber-master/cyber_master_mcp.py",
        "--server",
        "http://localhost:8888"
      ],
      "timeout": 300
    }
  }
}

For VS Code Copilot:

Open VS Code
Go to Settings (Ctrl+,)
Search for "MCP"
Add server configuration:

hljs language-json

{
  "servers": {
    "cyber-master": {
      "type": "stdio",
      "command": "python3",
      "args": [
        "/full/path/to/cyber-master/cyber_master_mcp.py",
        "--server",
        "http://localhost:8888"
      ]
    }
  }
}

Step 4: Restart AI Client

Close and reopen your AI client (Claude Desktop or VS Code).

Step 5: Verify Connection

Ask your AI assistant:

hljs language-arduino

"Can you check the health of the Cyber Master server?"

If connected, it will use the server_health tool.

How to Use

Basic Usage

Start the server:

hljs language-bash

cd cyber-master
source cyber-env/bin/activate
python3 cyber_master_server.py

Open your AI assistant (Claude Desktop, VS Code Copilot, etc.)
Start asking questions:

Example Commands

Network Scanning

hljs language-arduino

"Scan 192.168.1.1 for open ports using nmap"
"Run a comprehensive scan on example.com"
"Do a quick port scan on 10.0.0.1"

Web Application Testing

hljs language-arduino

"Check example.com for SQL injection vulnerabilities"
"Scan for XSS vulnerabilities on target.com"
"Find hidden directories on website.com"
"Test for command injection on api.target.com"

Vulnerability Assessment

hljs language-arduino

"Run a vulnerability scan on target.com using nuclei"
"Check for common misconfigurations on server.com"
"Scan for known CVEs in the target system"

Website Cloning

hljs language-arduino

"Clone the website example.com with all assets"
"Create a phishing simulation of login.example.com"
"Clone target.com with depth 2 and download assets"

Bug Bounty Workflow

hljs language-arduino

"Start a bug bounty recon workflow for target.com"
"Find all subdomains of example.com"
"Enumerate parameters on api.target.com"

Binary Analysis

hljs language-arduino

"Analyze this binary file for vulnerabilities"
"Check if this ELF binary has security protections"
"Find ROP gadgets in this binary"

Cloud Security

hljs language-arduino

"Audit my AWS account for security issues"
"Scan my Kubernetes cluster for vulnerabilities"
"Check my Docker images for CVEs"

Available Tools

Network Tools (25+)

nmap_scan() - Port scanning
rustscan_fast_scan() - Ultra-fast port scanning
masscan_high_speed() - High-speed port scanning
autorecon_comprehensive() - Full reconnaissance
amass_scan() - Subdomain enumeration

Web Tools (40+)

nuclei_scan() - Vulnerability scanning
nikto_scan() - Web server scanning
sqlmap_scan() - SQL injection testing
gobuster_scan() - Directory enumeration
ffuf_scan() - Web fuzzing
wpscan_analyze() - WordPress scanning

Binary Tools (25+)

ghidra_analysis() - Reverse engineering
radare2_analyze() - Binary analysis
gdb_peda_debug() - Debugging
checksec_analyze() - Security checks

Cloud Tools (20+)

prowler_scan() - AWS security
trivy_scan() - Container scanning
kube_hunter_scan() - Kubernetes testing

Bug Bounty Tools (20+)

bugbounty_reconnaissance_workflow() - Full recon
bugbounty_vulnerability_hunting() - Vuln hunting
bugbounty_osint_gathering() - OSINT collection

Configuration

Server Configuration

Edit cyber-master-mcp.json:

hljs language-json

{
  "mcpServers": {
    "cyber-master": {
      "command": "python3",
      "args": [
        "/path/to/cyber_master_mcp.py",
        "--server",
        "http://localhost:8888"
      ],
      "timeout": 300
    }
  }
}

Server Options

hljs language-bash

# Start on different port
python3 cyber_master_server.py --port 9000

# Start with debug mode
python3 cyber_master_server.py --debug

# Start with both
python3 cyber_master_server.py --port 9000 --debug

Environment Variables

hljs language-bash

# Set custom port
export CYBERMASTER_PORT=9000

# Set custom host
export CYBERMASTER_HOST=0.0.0.0

# Set log level
export CYBERMASTER_LOG=DEBUG

Troubleshooting

Problem: Server Won't Start

Solution:

hljs language-bash

# Check Python version
python3 --version

# Should be 3.8 or higher

# Check if port is in use
netstat -tlnp | grep 8888

# Kill existing process if needed
kill -9 <PID>

Problem: Tools Not Found

Solution:

hljs language-bash

# Check if tool is installed
which nmap

# Install missing tools
sudo apt install nmap

# Check PATH
echo $PATH

Problem: AI Client Can't Connect

Solution:

Verify server is running:
hljs language-bash
```
curl http://localhost:8888/health
```
Check MCP configuration path is correct
Restart AI client
Check server logs for errors

Problem: Permission Denied

Solution:

hljs language-bash

# Make scripts executable
chmod +x cyber_master_server.py
chmod +x cyber_master_mcp.py

# Check file permissions
ls -la

Problem: Slow Performance

Solution:

hljs language-bash

# Use faster scanning profile
python3 cyber_master_server.py --debug

# Check system resources
htop

# Reduce concurrent scans
# Edit server config to limit threads

FAQ

Q: Can I use this on Windows?

A: Yes, but Kali Linux is recommended for full functionality. On Windows, use WSL2.

Q: Do I need to install all 155 tools?

A: No. Start with core tools (nmap, nuclei, gobuster). Install others as needed.

Q: Is this legal?

A: Only use on systems you own or have written permission to test. Unauthorized testing is illegal.

Q: Can I run this without AI?

A: Yes. You can use the Python API directly. See the code examples in the source.

Q: How do I update?

hljs language-bash

cd cyber-master
git pull
pip install -r requirements.txt

Q: Can I contribute?

A: Yes! Fork the repository and submit a pull request.

Safety Notice

⚠️ IMPORTANT:

Only use on systems you own or have authorization to test
Unauthorized scanning is illegal and unethical
Always get written permission before testing
Use in isolated lab environments for learning
Follow responsible disclosure for any vulnerabilities found

Support

Author: Nikhil Gupta
Email: nikhilguptaji8@gmail.com

License

This project is for educational and authorized security testing purposes only.

Made with ❤️ by Nikhil Gupta for AI-powered security automation

Cyber-Master-MCP

Cyber Master MCP Server v1.0

AI-Powered Cybersecurity Automation Platform

Table of Contents

What is This?

Features

System Requirements

Minimum Requirements

Recommended

Installation

Step 1: Clone the Repository

Step 2: Create Virtual Environment

Step 3: Install Dependencies

Step 4: Install Security Tools

Step 5: Verify Installation

Setup Guide

Step 1: Start the Server

Step 2: Test Server Health

Step 3: Configure AI Client

For Claude Desktop:

For VS Code Copilot:

Step 4: Restart AI Client

Step 5: Verify Connection

How to Use

Basic Usage

Example Commands

Network Scanning

Web Application Testing

Vulnerability Assessment

Website Cloning

Bug Bounty Workflow

Binary Analysis

Cloud Security

Available Tools

Network Tools (25+)

Web Tools (40+)

Binary Tools (25+)

Cloud Tools (20+)

Bug Bounty Tools (20+)

Configuration

Server Configuration

Server Options

Environment Variables

Troubleshooting

Problem: Server Won't Start

Problem: Tools Not Found

Problem: AI Client Can't Connect

Problem: Permission Denied

Problem: Slow Performance

FAQ

Q: Can I use this on Windows?

Q: Do I need to install all 155 tools?

Q: Is this legal?

Q: Can I run this without AI?

Q: How do I update?

Q: Can I contribute?

Safety Notice

Support

License

Similar Packages

Cyber-Master-MCP

Cyber Master MCP Server v1.0

AI-Powered Cybersecurity Automation Platform

Table of Contents

What is This?

Features

System Requirements

Minimum Requirements

Recommended

Installation

Step 1: Clone the Repository

Step 2: Create Virtual Environment

Step 3: Install Dependencies

Step 4: Install Security Tools

Step 5: Verify Installation

Setup Guide

Step 1: Start the Server

Step 2: Test Server Health

Step 3: Configure AI Client

For Claude Desktop: