convez.ai
MCP ServerSegurançaAvançado
usaidm666

Aircrack MCP — Testes de Penetração WiFi

usaidm666/aircrack-mcp

Testes de pentest WiFi via aircrack-ng integrado ao Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server que encapsula a suite aircrack-ng (airmon-ng, airodump-ng, aireplay-ng, aircrack-ng) para testes de segurança wireless e auditorias de rede. Requer Linux, privilégios root e adaptador WiFi com suporte a monitor mode. Destinado EXCLUSIVAMENTE para testes autorizados em redes próprias ou com permissão explícita.

Instalação

$npx convez-ai usaidm666/aircrack-mcp

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
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Auditorias de segurança wireless em redes autorizadas
  • Testes de penetração WPA2/WPA3 com captura de handshake
  • Diagnóstico de vulnerabilidades em adaptadores WiFi

Veredito

Ferramenta legítima de segurança, mas com alto risco operacional: requer root, Linux, hardware específico e conformidade legal rigorosa. Recomendado apenas para profissionais de segurança qualificados em ambientes controlados e autorizados. A integração MCP é competente, mas o escopo é restritivo.

README

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

WiFi Penetration Testing MCP Server

⚠️ FOR AUTHORIZED SECURITY TESTING ONLY All operations must be performed on networks you own or have explicit written permission to test. Unauthorized access to computer networks is illegal under the Computer Fraud and Abuse Act (US), the Computer Misuse Act (UK), and similar laws worldwide.


Overview

This MCP server wraps the aircrack-ng suite (airmon-ng, airodump-ng, aireplay-ng, aircrack-ng) into a structured AI-accessible toolkit for wireless penetration testing and security audits.


Requirements

RequirementDetails
OSLinux (Kali, Parrot, Ubuntu)
Python3.10+
PrivilegesMust run as root (sudo)
WiFi adapterMust support monitor mode & packet injection
aircrack-ng suitesudo apt install aircrack-ng

Install aircrack-ng

sudo apt update && sudo apt install -y aircrack-ng

Optional (recommended)

sudo apt install -y tshark   # for handshake detection in capture files
sudo apt install -y hashcat  # for GPU-accelerated cracking (outside this MCP)

Installation

# Clone or copy the server files
cd wifi_pentest_mcp

# Install Python dependencies
pip install -r requirements.txt

# Run as root
sudo python server.py

Claude Desktop / MCP Client Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "wifi_pentest": {
      "command": "sudo",
      "args": ["python", "/path/to/wifi_pentest_mcp/server.py"]
    }
  }
}

Or using uv:

{
  "mcpServers": {
    "wifi_pentest": {
      "command": "sudo",
      "args": ["uv", "run", "/path/to/wifi_pentest_mcp/server.py"]
    }
  }
}

Available Tools

🔧 Setup & Diagnostics

ToolDescription
wifi_check_toolsVerify aircrack-ng suite is installed; list interfaces
wifi_list_interfacesList wireless interfaces with chipset/driver info
wifi_kill_interfering_processesKill NetworkManager, wpa_supplicant (optional dry-run)

📡 Monitor Mode

ToolDescription
wifi_enable_monitor_modeairmon-ng start <iface> — puts card into monitor mode
wifi_disable_monitor_modeairmon-ng stop <iface> — restores managed mode

🔍 Scanning & Capture

ToolDescription
wifi_scan_networksPassive scan for APs & clients via airodump-ng
wifi_capture_handshakeTargeted capture on one AP to collect WPA handshake

⚔️ Active Attacks

ToolDescription
wifi_deauth_attackaireplay-ng -0 — send deauth frames to disconnect clients
wifi_fake_authaireplay-ng -1 — fake-authenticate to a WEP AP
wifi_arp_replayaireplay-ng -3 — ARP replay to speed up WEP IV collection

🔑 Cracking

ToolDescription
wifi_crack_passwordaircrack-ng dictionary attack on .cap file
wifi_extract_handshakesList all handshakes in a capture file (no cracking)

Typical WPA2 Pentest Workflow

1. wifi_check_tools             → verify setup
2. wifi_list_interfaces         → find your adapter (e.g., wlan0)
3. wifi_kill_interfering_processes (dry_run=false)
4. wifi_enable_monitor_mode     → interface = "wlan0"  → gets "wlan0mon"
5. wifi_scan_networks           → interface = "wlan0mon", duration = 20
   (note target BSSID, channel, ESSID)
6. wifi_capture_handshake       → bssid, channel, interface, duration = 60
   (run simultaneously with step 7)
7. wifi_deauth_attack            → bssid, client = "FF:FF:FF:FF:FF:FF", count = 5
   (forces client re-auth → triggers 4-way handshake in capture)
8. wifi_extract_handshakes      → verify .cap has a handshake
9. wifi_crack_password          → capture_file, wordlist, bssid
10. wifi_disable_monitor_mode   → restore normal operation

Typical WEP Pentest Workflow

1–4. Same as above
5. wifi_scan_networks           → identify WEP target
6. wifi_capture_handshake       → start capturing IVs
7. wifi_fake_auth               → associate with AP
8. wifi_arp_replay              → accelerate IV generation (need 50,000+ IVs)
9. wifi_crack_password          → aircrack-ng cracks WEP automatically from IVs

Output Files

Capture files are saved to /tmp/wifi_pentest_mcp/ by default.

FileContents
<prefix>-01.capRaw packet capture (for cracking)
<prefix>-01.csvNetwork/client list from airodump-ng

Wordlists

WordlistPath
rockyou/usr/share/wordlists/rockyou.txt (Kali default)
SecLists/usr/share/seclists/Passwords/
CustomAny plaintext file, one password per line

Uncompress rockyou if needed: sudo gunzip /usr/share/wordlists/rockyou.txt.gz


Troubleshooting

ProblemSolution
airmon-ng not foundsudo apt install aircrack-ng
Interface not in monitor modeRun wifi_enable_monitor_mode first
No networks foundCheck adapter supports monitor mode
No handshake capturedRun wifi_deauth_attack to force reconnect
"Permission denied"Run server with sudo
Handshake not detectedInstall tshark: sudo apt install tshark

Legal Disclaimer

This tool is provided for educational and authorized security testing purposes only. The authors assume no liability for misuse. Always obtain explicit written authorization before testing any network you do not own.

Ver o original no GitHub

Bom para

Relacionados