kali-mcp-tool
Provides access to over 600 security, penetration testing, and forensic tools installed on Kali Linux, including arbitrary command execution, tool search, manpage retrieval, and structured wrappers for common tools like nmap, sqlmap, gobuster, and searchsploit.
Allows Metasploit to be executed as one of the Kali Linux penetration testing tools, enabling exploitation and security assessment workflows.
Allows Wireshark to be executed as one of the Kali Linux tools, enabling network traffic analysis and packet inspection.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kali-mcp-tool Scan 192.168.1.1 for open ports using nmap"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.pyinside a VirtualBox Kali VM (listening on host-only or bridged network adapter).Run
client.pyon your Windows Host insidemcp.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--helpdocumentation 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
Scenario 1: VirtualBox / Remote Kali Setup (Recommended for Windows Host + Kali VM)
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 8000In VSCode / Claude Desktop / Antigravity IDE on Windows Host: Configure your
mcp.jsonfile:{ "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!
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 |
| Execute any arbitrary shell command natively on Kali with timeout control. |
| Search installed Kali tools by name, keyword, or category. |
| Dynamically fetch manpages ( |
| High-level Nmap port/service scanner wrapper. |
| Automatic SQL injection scan wrapper. |
| Web directory & DNS brute-forcing wrapper. |
| Search ExploitDB offline exploit database. |
| Read, write, list, or delete scan logs & target lists in workspace directory. |
Security & Ethics 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 toolskali_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
AI pentesting: run scans, triage vulnerabilities, review PRs, manage schedules and assets.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Real-time CVE, exploit, and vulnerability intelligence for AI assistants (350K+ CVEs, 115K+ PoCs)
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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-
- FlicenseNot gradedqualityDmaintenanceConnects 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-
- AlicenseNot gradedqualityDmaintenanceEnables 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.2MIT
- AlicenseAqualityDmaintenanceEnables 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.191MIT