convez.ai
MCP ServerSegurançaAvançado
charles-future

MCP Kali Server

charles-future/MCP-Kali-Server

Bridge MCP para penetration testing automatizado com IA em Kali Linux

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que funciona como ponte entre clientes IA (Claude, Ollama, etc.) e uma máquina Kali Linux, permitindo execução remota de comandos e ferramentas de penetration testing. Integra ferramentas como Nmap, Metasploit, sqlmap e WPScan para testes ofensivos assistidos por IA, automação de reconhecimento e resolução de CTF challenges.

Instalação

$npx convez-ai charles-future/MCP-Kali-Server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Testes de penetração assistidos por IA
  • Automação de desafios CTF (Capture The Flag)
  • Reconhecimento e enumeração remotos
  • Bug bounty hunting com sugestões de IA

Veredito

Ferramenta especializada e poderosa para profissionais de segurança que desejam automatizar testes ofensivos via IA. Requer conhecimento sólido em segurança e cuidado extremo com exposição de rede — não é para iniciantes.

README

A tradução para o português deste README ainda está na fila.

MCP Kali Server

MCP Kali Server (MKS) is a lightweight API bridge that connects MCP clients (e.g: Claude Desktop or 5ire) to the API server which allows executing commands on a Linux terminal.

This MCP is able to run terminal commands as well as interacting with web applications using:

  • Dirb
  • enum4linux
  • gobuster
  • Hydra
  • John the Ripper
  • Metasploit-Framework
  • Nikto
  • Nmap
  • sqlmap
  • WPScan
  • As well as being able to execute raw commands.

As a result, this is able to perform AI-assisted penetration testing and solving CTF challenges in real time.

Articles Using This Tool

How MCP is Revolutionizing Offensive Security

👉 How MCP is Revolutionizing Offensive Security


🔍 Use Case

The goal is to enable AI-driven offensive security testing by:

  • Letting the MCP interact with AI endpoints like OpenAI, Claude, DeepSeek, Ollama or any other models.
  • Exposing an API to execute commands on a Kali machine.
  • Using AI to suggest and run terminal commands to solve CTF challenges or automate recon/exploitation tasks.
  • Allowing MCP apps to send custom requests (e.g. curl, nmap, ffuf, etc.) and receive structured outputs.

Here are some example (using Google's AI gemini 2.0 flash):

Example solving a web CTF challenge from RamadanCTF

https://github.com/user-attachments/assets/dc93b71d-9a4a-4ad5-8079-2c26c04e5397

Trying to solve machine "code" from HTB

https://github.com/user-attachments/assets/3ec06ff8-0bdf-4ad5-be71-2ec490b7ee27


🚀 Features

  • 🧠 AI Endpoint Integration: Connect your Kali to any MCP of your liking such as Claude Desktop or 5ier.
  • 🖥️ Command Execution API: Exposes a controlled API to execute terminal commands on your Kali Linux machine.
  • 🕸️ Web Challenge Support: AI can interact with websites and APIs, capture flags via curl and any other tool AI the needs.
  • 🔐 Designed for Offensive Security Professionals: Ideal for red teamers, bug bounty hunters, or CTF players automating common tasks.

🛠️ Installation and Running

On your Kali Machine

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

Otherwise for bleeding edge:

git clone https://github.com/Wh0am123/MCP-Kali-Server.git
cd MCP-Kali-Server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
./server.py

Command Line Options:

  • --ip <address>: Specify the IP address to bind the server to (default: 127.0.0.1 for localhost only)
    • Use 127.0.0.1 for local connections only (secure, recommended)
    • Use 0.0.0.0 to allow connections from any network interface (very dangerous; use with caution)
    • Use a specific IP address to bind to a particular network interface
  • --port <port>: Specify the port number (default: 5000)
  • --debug: Enable debug mode for verbose logging

Examples:

# Run on localhost only (secure, default)
./server.py

# Run on all interfaces (less secure, useful for remote access)
./server.py --ip 0.0.0.0

# Run on a specific IP and custom port
./server.py --ip 192.168.1.100 --port 8080

# Run with debug mode
./server.py --debug

On your MCP client machine

This can be local (on the same Kali machine) or remote (another Linux machine, Windows or macOS).

If you're running the client and server on the same Kali machine (aka local), run either:

## OS package
kali-server-mcp --server http://127.0.0.1:5000

# ...OR...

## Bleeding edge
./client.py --server http://127.0.0.1:5000

If separate machines (aka remote), create an SSH tunnel to your MCP server, then launch the client:

## Terminal 1 - Replace `LINUX_IP` with Kali's IP
ssh -L 5000:localhost:5000 user@LINUX_IP

## Terminal 2
git clone https://github.com/Wh0am123/MCP-Kali-Server.git
cd MCP-Kali-Server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
./client.py --server http://127.0.0.1:5000

If you're openly hosting the MCP Kali server on your network (server.py --IP...), you don't need the SSH tunnel (but we do recommend it!) NOTE: ⚠️(THIS IS STRONGLY DISCOURAGED. WE RECOMMEND SSH)⚠️.

./client.py --server http://LINUX_IP:5000

Configuration for Claude Desktop:

Edit:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Example MCP-Kali-Server.json

Configuration for 5ire Desktop Application:

  • Simply add an MCP with the command python3 /absolute/path/to/client.py --server http://LINUX_IP:5000 and it will automatically generate the needed configuration files.

🔮 Other Possibilities

There are more possibilities than described since the AI model can now execute commands on the terminal. Here are some examples:

  • Memory forensics using Volatility

    • Automating memory analysis tasks such as process enumeration, DLL injection checks, and registry extraction from memory dumps.
  • Disk forensics with SleuthKit

    • Automating analysis from disk images, timeline generation, file carving, and hash comparisons.

⚠️ Disclaimer:

This project is intended solely for educational and ethical testing purposes. Any misuse of the information or tools provided — including unauthorized access, exploitation, or malicious activity — is strictly prohibited.

The author assumes no responsibility for misuse.

Ver o original no GitHub

Bom para

Relacionados