PlugWiki
MCP-Kali-Server logo

MCP-Kali-Server: connect Claude to Kali Linux tools

CommunityLocal

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.

Install MCP-Kali-Server

Claude Desktop

  1. 1

    Open this file. Create it if it does not exist.

  2. 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. 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_scan

  • Lists 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_scan

  • Lists 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_scan

  • Checks 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_scan

  • Reports 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_analyze

  • Tests 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_scan

  • Lists 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_scan

  • Tests 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_attack

  • Recovers 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_crack

  • Runs 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_run

  • Runs 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_command

  • Used 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 toYour Kali machine (port 5000). Any target the assistant scans
Sign-in and keysNone: 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.

ServerOfficialRunsGitHub starsLast commit
MCP-Kali-ServerThis pageCommunityLocal866Mar 2026
awsome_kali_MCPServersCommunityLocal110Nov 2025
zebbern-kali-mcpCommunityLocal52Oct 2026
kali-mcp-goCommunityLocal25Oct 2026
kali-ssh-mcpCommunityLocal24Aug 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

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

  • Solve a web CTF challenge from RamadanCTF

    Source
  • Work through the Hack The Box machine "code"

    Source
  • Run recon and enumeration on an authorized target

    Scan 10.10.11.5 with nmap for open services, then run gobuster on any web port you find.

  • Memory forensics with Volatility through raw commands

    Source

Information

updated Nov 2, 2026

Publisher
Community
Transport
stdio
Auth
None
License
MIT
Last commit
Mar 17, 2026
Open issues
4

GitHubKali package (apt)Official listingChangelogIssues

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 7
  1. MCP Kali Server README · github.com
  2. mcp-kali-server | Kali Linux Tools · kali.org
  3. client.py · github.com
  4. Add mandatory API key authentication and TLS encryption · github.com
  5. Command Injection via Unescaped Argument Interpolation (CWE-78) · github.com
  6. Fix command injection (CWE-78) across all tool endpoints · github.com
  7. Windows client side error cannot solve. · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.