MCP Server for Breaking Shyet - Diclaimer - This is a DEVKIT

A Model Context Protocol (MCP) server that connects Claude for Desktop with Kali Linux security tools, enabling AI-assisted penetration testing

Architecture

This project consists of two main components:

1. MCP Server (mcp_server.py): Implements the Model Context Protocol to connect Claude for Desktop with the Kali Linux tools API. It provides capabilities, prompts, and context to help Claude understand how to use the Kali tools effectively.

2. Kali Linux API Server (kali_api_server.py): A Flask application that provides API endpoints for executing various Kali Linux security tools. It handles the actual execution of commands and returns the results to the MCP server.

Claude for Desktop ←→ MCP Server ←→ Kali Linux API Server ←→ Kali Linux Tools

Features

• Integration with popular Kali Linux security tools
• Pre-defined pentesting prompts for common tasks
• Contextual information about HackTheBox environments
• Comprehensive debugging tools for troubleshooting

Prerequisites

• Kali Linux (or other Linux distribution with security tools installed)
• Python 3.8+
• Claude for Desktop
• The following Python packages (installed automatically in a virtual environment):
  • Flask
  • Requests
  • psutil (for system diagnostics)

Installation

Option 1: Using the setup script (Recommended)

1. Clone this repository:

   git clone https://github.com/yourusername/kali-mcp-server.git
   cd kali-mcp-server
   

2. Run the setup script:

   ./setup.sh
   

Option 2: Manual setup

1. Clone this repository:

   git clone https://github.com/yourusername/kali-mcp-server.git
   cd kali-mcp-server
   

2. Create a virtual environment:

   python3 -m venv venv
   

3. Activate the virtual environment:

   source venv/bin/activate
   

4. Install dependencies:

   pip install -r requirements.txt
   

5. Make the scripts executable:

   chmod +x mcp_server.py kali_api_server.py run.py
   

Ensure required Kali Linux tools are installed

Make sure the relevant Kali Linux tools are installed on your system:

sudo apt update
sudo apt install nmap gobuster dirb nikto sqlmap metasploit-framework hydra john wpscan enum4linux

Usage

Using the run.py script (Recommended)

The easiest way to start both servers is using the run.py script:

./run.py

This will start both the API server and MCP server in separate terminals.

Additional options:

• --api-port PORT: Specify the API server port (default: 5000)
• --mcp-port PORT: Specify the MCP server port (default: 8080)
• --background: Run both servers in the background
• --setup: Set up or update the virtual environment
• --debug: Enable debug mode with detailed logging and diagnostic endpoints

Starting servers manually

If you prefer to start the servers manually:

1. Start the Kali Linux API Server:

   source venv/bin/activate
   python kali_api_server.py
   

2. In a new terminal, start the MCP Server:

   source venv/bin/activate
   python mcp_server.py
   

Connect Claude for Desktop

1. Open Claude for Desktop
2. Configure it to use the MCP server at http://localhost:8080
3. Start a new conversation and begin your penetration testing

Configuring Claude for Desktop (Linux)

If you're using the unofficial Claude Desktop for Linux build:

1. Edit the MCP configuration file:

   nano ~/.config/Claude/claude_desktop_config.json
   

2. Add your MCP server:

   {
     "mcp_servers": [
       {
         "name": "Kali Linux Tools",
         "url": "http://localhost:8080",
         "enabled": true
       }
     ]
   }
   

3. Save the file and restart Claude Desktop

Supported Tools

1. nmap: Network scanning and host discovery

   {
     "target": "10.10.10.10",
     "scan_type": "-sV",
     "ports": "80,443,22",
     "additional_arg
   

... View full README on GitHub