
MCP-Kali-Server: connect Claude to Kali Linux tools
Lets Claude or another AI assistant run Kali Linux tools like nmap, gobuster, sqlmap and Metasploit, or any shell command, on your Kali machine.
This community project, written by Wh0am123 and shipped in Kali's own package repository, connects your AI assistant to a Kali machine. The assistant can run scanners, password crackers and Metasploit modules, or any terminal command, and read the results. The one thing to know is that it really runs those commands, with no password on the Kali side, so use it in a throwaway VM and only against systems you are allowed to test.
Good for
- Penetration testers who want an assistant to run recon and enumeration on authorized targets
- CTF players and Hack The Box learners who want help solving challenges in real time
- Bug bounty hunters automating repetitive scanning steps
- Forensics learners who want the assistant to drive tools like Volatility through the shell
Works in
1 supported · 11 should work
Tap an app to see how to set it up and any known problems.
The README gives a Claude Desktop config that starts the bridge and points it at your Kali machine. GitHub
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install MCP-Kali-Server
Claude Desktop
- 1
Open this file. Create it if it does not exist.
- 2
Add this entry. If the file already lists servers, add it next to them.
json{ "mcpServers": { "mcp-kali-server": { "command": "python3", "args": [ "/absolute/path/to/client.py", "--server", "http://127.0.0.1:5000/" ], "timeout": 300 } } } - 3
Quit and reopen Claude Desktop to load it.
Requires A Kali machine with the API server running, Python 3.
Read-only mode: None. Every tool runs commands on the Kali machine, so run it in a disposable VM and approve each command.
First, on the Kali machine, install the package with sudo apt install mcp-kali-server and start the API server with kali-server-mcp (it listens on 127.0.0.1:5000). If Claude runs on a different machine, open an SSH tunnel first (ssh -L 5000:localhost:5000 user@kali-ip) and keep the address http://127.0.0.1:5000/. Point command/args at the client.py from the repo, or use the packaged mcp-server command instead. Do not bind the Kali server to 0.0.0.0; the API has no password.
From the project README. Source.
Tools
Maps open ports and running services on a host
Runs Nmap against a host or network on the Kali machine and reports which ports are open and what services answer on them.
Try: “Scan 10.10.11.5 and list its open ports and service versions”
Runs code ·
nmap_scanLists a site's directories, subdomains or virtual hosts
Runs Gobuster against a website to enumerate directories, DNS subdomains or virtual hosts from a wordlist.
Try: “Enumerate directories on http://10.10.11.5”
Runs code ·
gobuster_scanLists pages and folders on a website
Runs Dirb, a web content scanner that checks common paths on a site to list pages that are not linked.
Try: “Run a dirb content scan on http://target.htb”
Runs code ·
dirb_scanChecks a web server's configuration and software
Runs Nikto against a web server to report outdated software, notable files and common misconfigurations.
Try: “Run a Nikto check on http://10.10.11.5”
Runs code ·
nikto_scanReports a WordPress site's version, plugins and themes
Runs WPScan against a WordPress site to list its version, plugins, themes and any issues recorded for them.
Try: “Analyze the WordPress site at http://blog.target.htb”
Runs code ·
wpscan_analyzeTests a web page for SQL injection
Runs SQLmap against a URL, with optional form data, to test whether its database queries can be influenced by input.
Try: “Test http://target.htb/item.php?id=1 with sqlmap”
Runs code ·
sqlmap_scanLists users, shares and details from a Windows or Samba host
Runs enum4linux against a Windows or Samba host to list users, shared folders and system information.
Try: “Enumerate the SMB shares on 10.10.11.20”
Runs code ·
enum4linux_scanTests login services against a list of credentials
Runs Hydra against a login service to check a list of usernames and passwords, the way a security test audits weak credentials.
Try: “Test SSH on 10.10.11.5 against my wordlist”
Runs code ·
hydra_attackRecovers passwords from a captured hash file
Runs John the Ripper over a file of password hashes to recover the plaintext, used to audit password strength.
Try: “Run John the Ripper on the hashes in dump.txt”
Runs code ·
john_crackRuns a Metasploit module with the options you set
Runs a chosen Metasploit Framework module with the options you give it, for example to check a host against a known weakness.
Try: “Run the smb_version auxiliary module against 10.10.11.20”
Runs code ·
metasploit_runRuns any terminal command on the Kali machine
Runs any shell command on the Kali machine and returns its output, so the assistant can use tools beyond the ones listed here.
Try: “Run whoami and ip addr on the Kali box”
Runs code ·
execute_commandUsed by the assistant behind the scenes
Checks that the Kali API server is reachable
Checks whether the Kali API server is up and which expected tools it has available.
Try: “Is the Kali server connected?”
Network ·
server_health
Read from the source code
Pros and cons
Good
- Shipped in Kali's own package repository, so one apt command installs it.
- Covers common pentest tools: nmap, gobuster, dirb, nikto, sqlmap, Metasploit, Hydra, John the Ripper, WPScan and enum4linux.
- Can also run any shell command, so it is not limited to the built-in tools.
- Works with any local AI client, including Claude Desktop, 5ire and LM Studio.
- Listens only on localhost by default.
- Most starred Kali server, MIT licensed.
Watch out
- No password or key on the Kali API.
- No read-only mode; every tool acts on the target or the machine.
- Text from scanned targets can steer the AI into running other commands.
- Remote use needs an SSH tunnel and a Python setup on your own machine.
- No upstream code changes since March 2026, with fixes waiting in open pull requests.
Permissions
high risk · 5 things to watch
High risk
The assistant can run any command on your Kali machine, and anyone who reaches its port can too. Run it in a disposable VM bound to localhost, connect over SSH, and approve each command yourself.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can run any command on your Kali box
One tool passes any shell command to the Kali machine as the user running the server. Run it in a disposable VM and approve each command. github.com
The Kali side has no password
Anyone who can reach port 5000 can run commands. Keep the default localhost setting and connect over an SSH tunnel. github.com
Scanned pages can steer the AI
Text in web pages, DNS records or files can trick the model into running other commands. Do not set tools to always allow. github.com
Only test systems you are allowed to
The scanners and password crackers are attack tools. The project limits use to education and authorized testing. github.com
Command injection in tool options was fixed
Tool options were passed to a shell until March 2026. The fix is in the Kali package. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Talks to | Your Kali machine (port 5000). Any target the assistant scans |
|---|---|
| Sign-in and keys | None: the Kali API server accepts requests without a key. |
Alternatives
Use this server if you want the one Kali packages and the most starred option. Pick zebbern-kali-mcp to keep Kali in Docker, or kali-ssh-mcp to drive a VM over SSH.
| Server | Official | Runs | GitHub stars | Last commit |
|---|---|---|---|---|
| MCP-Kali-ServerThis page | Community | Local | 866 | Mar 2026 |
| awsome_kali_MCPServers | Community | Local | 110 | Nov 2025 |
| zebbern-kali-mcp | Community | Local | 52 | Oct 2026 |
| kali-mcp-go | Community | Local | 25 | Oct 2026 |
| kali-ssh-mcp | Community | Local | 24 | Aug 2026 |
What people say
People like how much of a pentest it can drive and worry about how much it can run.
What people like
- A user ran it from LM Studio on Windows against a Kali box on their network for months without trouble.
Common complaints
- A security researcher showed that content from scanned targets could steer the AI into running commands.
- Newer versions of the mcp Python library broke the Windows client.
- Setting up the client side means managing a Python virtual environment.
In their words
“I had been using the Kali MCP Server on my LM Studio app in windows flawlessly for months.”PblarnerdGitHub issueFeb 2026
“AI can be manipulated via prompt injection from content it reads during a pentest session (HTTP responses, DNS records, file contents), creating a prompt injection to command injection chain with zero human interaction required.”evilsocket
Questions
Is it free?
Yes. It is open source under the MIT license and installs from Kali's repository at no cost. You still pay for whatever AI model you connect it to.
Is it made by Kali?
No. It is a community project by Wh0am123, but Kali packages it in its own repository, so you can install it with apt.
Is it safe?
Only in a controlled setup. It can run any command on the Kali machine and has no password on its API. Use a disposable VM, keep it on localhost, and approve each command.
Can I use it from my Mac or Windows PC?
Yes. Run the server on Kali, open an SSH tunnel to port 5000 from your computer, and run the client there. The README strongly advises against opening the port to your network instead.
Why does the Windows client say No module named mcp.server.fastmcp?
A newer version of the mcp Python library broke the client. A user's workaround is to pin mcp to version 1.6 or later but below 2 in requirements.txt before installing.
Which AI models work with it?
Any model behind a client that runs local servers. The README's demos use Gemini 2.0 Flash, and it names Claude, OpenAI, DeepSeek and Ollama.
Can it delete files or break things?
Yes. Raw commands run with the permissions of the user who started the server, and tools like sqlmap or Metasploit act on the target. Never run the server as root.
Is it legal to use?
Only against systems you own or have written permission to test. The project forbids unauthorized access.
Examples
Information
updated Nov 2, 2026
- Publisher
- Community
- Transport
- stdio
- Auth
- None
- License
- MIT
- Last commit
- Mar 17, 2026
- Open issues
- 4
Other Kali Linux MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 7Hide
- MCP Kali Server README · github.com
- mcp-kali-server | Kali Linux Tools · kali.org
- client.py · github.com
- Add mandatory API key authentication and TLS encryption · github.com
- Command Injection via Unescaped Argument Interpolation (CWE-78) · github.com
- Fix command injection (CWE-78) across all tool endpoints · github.com
- Windows client side error cannot solve. · github.com