MCP Kali Server

A bridge between an MCP client and a Kali Linux terminal so the agent can run nmap, sqlmap, hydra and other tools for authorized pentesting and CTF

  • 872 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Runs arbitrary commands in a Kali terminal
  • Built for offensive security; use only on your own systems and with authorization
  • A server exposed on an external interface grants remote shell access
All reasons and checks

wh0am123/mcp-kali-server

Install

Manual install

sudo apt install mcp-kali-server
kali-server-mcp

On the Kali box: install via the OS package and start the API server.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Runs arbitrary commands in a Kali terminal
  • Built for offensive security; use only on your own systems and with authorization
  • A server exposed on an external interface grants remote shell access

This is third-party code. Review the repository files before installing.

What it does

The project pairs an API server that runs on the Kali box with an MCP client that connects an AI agent to it. The server exposes controlled terminal access and a set of tools: dirb, enum4linux, gobuster, hydra, john, metasploit, nikto, nmap, sqlmap, wpscan, plus arbitrary commands. The agent proposes and runs commands, reads the output and continues recon or exploitation. By default the server binds to localhost only, and the authors recommend an SSH tunnel for remote use.

Who it is for. For offensive security specialists and CTF players who test their own infrastructure.

Good fit when

  • You want the agent to handle recon and routine pentest steps on your own lab
  • You solve CTF and want the agent to pick commands itself
  • You need Kali terminal access from an MCP client

Not a fit when

  • You have no written permission to test the target
  • The target belongs to a third party without authorization
  • You cannot expose the server on an external interface without protection

Example request

Scan my lab host at 127.0.0.1 with nmap and suggest the next step

MCP

Transport
stdio
Authentication
not required

Limitations

The server runs commands in a Kali terminal, so it must not be opened to an untrusted network: binding to 0.0.0.0 without a tunnel is dangerous. It needs the Kali tools installed and a configured MCP client. Model API keys for OpenAI, Anthropic and similar are configured separately in the client.

How to disable. Stop the server.py and client.py processes and remove the MCP entry from the client config. The OS package is removed with the standard package manager.

FAQ

Is it safe to expose on the network?

No. By default the server listens on localhost. The authors advise against binding to 0.0.0.0; use an SSH tunnel for remote work.

Which clients work with it?

MCP clients such as Claude Desktop and 5ire; the repository ships an example configuration.

Discussion

No questions or reviews yet.

An offensive security MCP server: the agent runs 150+ pentest and recon tools and drives automated target assessments

MCP serverBroad access13.5KRepository stars

An MCP server that gives the agent vulnerability triage: NVD data, EPSS, the CISA KEV catalog, MITRE ATT&CK mapping and one-call CVE risk scoring

MCP serverExtended access1.8KRepository stars

cvENGINE finds a domain's exposed assets and the vulnerabilities being exploited, and its MCP server drives scans from Claude Code

MCP serverBroad access713Repository stars

Security scanner for MCP servers that looks for hardcoded keys, tool poisoning and injection flaws in repository code.

CLIMinimal access140Repository stars
Official

Self-hosted AI pentesting framework: attack surface graph, Kali sandbox, human approval gates and an MCP server you can drive from Claude Code

MCP serverBroad access3.4KRepository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
MCP Kali Server (this card)nonot required872
kubectl-mcp-servernonot required972reads cluster state and diagnoses pod failures
Unreal Engine MCP Servernonot required1,033Unreal Engine assets, actors and blueprints
Android MCPnonot required924controls an Android device through ADB

README in short

The README covers install via an OS package and from source, server run options (address, port, debug mode) and client setup locally or over an SSH tunnel. It gives examples for Claude Desktop and 5ire and walkthroughs for web CTF and HTB machines. It also notes forensics options through Volatility and SleuthKit. It ends with a disclaimer: legal and ethical testing only.

README badge

Report a problem