Skip to main content
Glama

Kali Linux MCP Server & Client

A high-performance Model Context Protocol (MCP) Server and Client ecosystem running natively on Kali Linux, providing AI assistants (VSCode, Claude Desktop, Antigravity IDE) full, structured access to all 600+ installed security, penetration testing, and forensic tools.


Features

  • 600+ Kali Tools Available: Execute any binary tool in the full Kali suite natively (Nmap, Metasploit, Sqlmap, Gobuster, Nikto, John the Ripper, Hydra, Wireshark, Searchsploit, Ghidra, etc.).

  • VirtualBox / Remote VM Support:

    • Run server.py inside a VirtualBox Kali VM (listening on host-only or bridged network adapter).

    • Run client.py on your Windows Host inside mcp.json. It bridges local Stdio to remote Kali SSE HTTP seamlessly!

  • Dual Transport Architecture:

    • Stdio Mode: For single-machine local setup.

    • SSE HTTP Mode: For cross-machine or VirtualBox / VMware / WSL2 setups.

  • Dynamic Tool Discovery & Manpages: Automatically search installed tools by category and query manpages (man <tool>) or --help documentation on the fly.

  • Structured Wrappers & Workspace Management: Includes high-level JSON wrappers for key tools (nmap, sqlmap, gobuster, searchsploit) and local artifact/file management.


Related MCP server: MCP Kali Server

Installation

On Kali Linux (Server)

git clone https://github.com/your-repo/kali-mcp.git
cd kali-mcp
python3 -m pip install -r requirements.txt
python3 -m pip install -e .

On Windows Host (Client)

git clone https://github.com/your-repo/kali-mcp.git
cd kali-mcp
pip install -r requirements.txt
pip install -e .

Usage Scenarios

  1. On VirtualBox Kali VM: Check your Kali VM host-only or bridged IP address (ip a, e.g. 192.168.56.101), then run the server:

    python3 server.py --host 0.0.0.0 --port 8000
    # Or using the installed CLI:
    kali-mcp-server --host 0.0.0.0 --port 8000
  2. In VSCode / Claude Desktop / Antigravity IDE on Windows Host: Configure your mcp.json file:

    {
      "mcpServers": {
        "kali-linux": {
          "command": "python",
          "args": [
            "C:/path/to/kali-mcp-tool/client.py",
            "--server", "192.168.56.101",
            "--port", "8000"
          ]
        }
      }
    }

    Alternatively, if installed via pip install -e ., you can use the installed CLI command directly:

    {
      "mcpServers": {
        "kali-linux": {
          "command": "kali-mcp-client",
          "args": [
            "--server", "192.168.56.101",
            "--port", "8000"
          ]
        }
      }
    }

    The client will bridge Stdio from your IDE directly to your VirtualBox Kali VM over SSE!

  3. Interactive Terminal Client (Optional): You can test tools directly from a terminal prompt:

    python client.py --server 192.168.56.101 --port 8000 --interactive
    # Or:
    kali-mcp-client --server 192.168.56.101 --port 8000 --interactive

Scenario 2: Local Single-Environment Setup (Running inside Kali directly)

If your IDE is running directly on Kali Linux:

{
  "mcpServers": {
    "kali-linux": {
      "command": "python3",
      "args": [
        "/path/to/kali-mcp-tool/server.py"
      ]
    }
  }
}

Or using the installed command:

{
  "mcpServers": {
    "kali-linux": {
      "command": "kali-mcp-server"
    }
  }
}

Available MCP Tools

Tool

Description

kali_execute_command

Execute any arbitrary shell command natively on Kali with timeout control.

kali_search_tools

Search installed Kali tools by name, keyword, or category.

kali_get_tool_help

Dynamically fetch manpages (man) or --help documentation for any tool.

kali_run_nmap

High-level Nmap port/service scanner wrapper.

kali_run_sqlmap

Automatic SQL injection scan wrapper.

kali_run_gobuster

Web directory & DNS brute-forcing wrapper.

kali_run_searchsploit

Search ExploitDB offline exploit database.

kali_manage_workspace

Read, write, list, or delete scan logs & target lists in workspace directory.


Security & Ethics Warning

WARNING

Penetration testing tools shouldonly be executed against targets you own or have explicit, documented permission to test. Always operate responsibly and in accordance with applicable laws.

Available Tools

8 tools
kali_execute_commandB

Executes a shell command directly on the Kali Linux host system.

Args: command: The shell command line to execute (e.g. 'nmap -sS 192.168.1.1', 'nikto -h http://example.com') timeout_seconds: Maximum time in seconds before terminating the command (default: 300s) cwd: Working directory path for execution (default: ./kali_workspace)

Inputs: command (required), cwd, timeout_seconds. Returns: result

kali_get_tool_helpA

Retrieves complete manual (manpage) or --help documentation for any Kali Linux tool.

Args: tool_name: Name of the binary utility (e.g. 'nmap', 'sqlmap', 'john', 'aircrack-ng')

Inputs: tool_name (required). Returns: result

kali_manage_workspaceA

Manages files inside the local Kali workspace folder.

Args: action: 'list' (list files), 'read' (read file content), 'write' (create/overwrite file), 'delete' (remove file) filename: Relative filename in workspace content: Text content (required when action is 'write')

Inputs: action (required), content, filename. Returns: result

kali_run_gobusterB

Runs Gobuster URI/directory brute-forcer.

Args: target_url: Target URL (e.g. 'http://192.168.1.100') wordlist: Path to wordlist file (default: '/usr/share/wordlists/dirb/common.txt') options: Additional gobuster dir flags (e.g. '-x php,html,txt')

Inputs: target_url (required), options, wordlist. Returns: result

kali_run_nmapB

Runs Nmap network scanner against target hosts with options.

Args: target: Target IP address, hostname, or subnet (e.g. '192.168.1.1' or 'scanme.nmap.org') options: Nmap flags (default: '-sV -F' fast service version scan)

Inputs: target (required), options. Returns: result

kali_run_searchsploitA

Searches Exploit-DB offline database via Searchsploit.

Args: query: Search keywords (e.g. 'Apache 2.4', 'WordPress 5.0', 'Linux Kernel 5.4')

Inputs: query (required). Returns: result

kali_run_sqlmapA

Runs Sqlmap automatic SQL injection and database takeover tool.

Args: target_url: Target URL to test (e.g. 'http://testphp.vulnweb.com/artists.php?artist=1') options: Sqlmap flags (default: '--batch --banner' non-interactive banner scan)

Inputs: target_url (required), options. Returns: result

kali_search_toolsA

Searches installed Kali Linux tools by name, keyword, or category.

Categories include: 'information-gathering', 'vulnerability-analysis', 'web-application-analysis', 'password-attacks', 'wireless-attacks', 'reverse-engineering', 'exploitation-tools', 'sniffing-spoofing', 'post-exploitation', 'forensics'

Inputs: query, category. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation3/5

    The generic kali_execute_command overlaps with the dedicated run_nmap, run_sqlmap, run_gobuster, and run_searchsploit wrappers, since the same operations can be performed through either path. However, the tool descriptions clarify intended use, and the other tools are functionally distinct.

    Naming Consistency5/5

    All tools consistently use the kali_ prefix and follow a clear verb_noun pattern such as execute_command, search_tools, run_nmap, and manage_workspace. This makes the toolset predictable and easy to navigate.

    Tool Count5/5

    Eight tools is a well-scoped size for a Kali Linux MCP server: generic execution, tool discovery, help retrieval, several common security tool wrappers, and workspace file management cover the main use cases without unnecessary bloat.

    Completeness4/5

    The set covers the core Kali workflow of finding tools, reading documentation, running common scanners, searching exploits, and managing workspace files. The generic command executor fills many long-tail gaps, though there is no dedicated handling for results post-processing or less common tool categories.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to execute penetration testing commands and security tools on Kali Linux remotely. Supports automated reconnaissance, vulnerability scanning, and CTF solving through integration with 25+ offensive security tools like nmap, gobuster, and nuclei.
      16
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to 55+ Kali Linux security tools for automated CTF solving, penetration testing, and security analysis across 7 categories including cryptography, forensics, web security, and binary exploitation.
      80
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform penetration testing and security assessments by exposing 60+ Kali Linux security tools including network scanning, web security testing, password cracking, exploitation frameworks, and OSINT capabilities through an AI-friendly interface.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to perform authorized penetration testing and security assessments by exposing 20+ Kali Linux security tools (nmap, sqlmap, gobuster, hydra, etc.) through a safe, validated interface with command allowlists, rate limiting, and input sanitization.
      19
      1
      MIT