AI导哈

WiFi测试自动化工具

Aircrack-ng Advanced MCP Server是一个用于自动化WiFi测试的工具，专为伦理渗透测试和无线网络安全审计设计，适用于受控环境中的安全研究。

  • by coliovacruz
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 coliovacruz/Aircrack-ng-Advanced-MCP-Server

使用说明

Aircrack-ng高级MCP服务器

使用Aircrack-ng套件进行WiFi测试自动化的先进MCP（模型上下文协议）服务器。用于在受控环境中进行伦理pentesting和无线安全审计。

法律声明

⚠️ 仅供道德和授权使用

本项目仅用于：

  • 授权Pentesting
  • 自有网络安全审计
  • 经同意的学术研究
  • 网络安全培训

请勿在非您的网络上使用，或未经明确授权。

特征

  • Aircrack-ng 工具的 MCP 接口
  • 自动扫描WiFi
  • WPA/WPA2握手仪式
  • WPS网络分析
  • 受控的取消身份验证攻击
  • 详细的审计报告
  • 蜜罐WiFi com专属门户
  • 实时监控

先决条件

操作系统

  • Kali Linux （推荐）
  • Ubuntu/Debian 有安全仓库
  • Arch Linux pentesting 软件包

硬件

  • 支持监视器模式的WiFi接口
  • 推荐：专用WiFi USB适配器（例如：Alfa AWUS036ACS）

基本软件

# Atualizar sistema
sudo apt update && sudo apt upgrade -y

# Pacotes essenciais
sudo apt install -y \
    aircrack-ng \
    reaver \
    hashcat \
    hostapd \
    dnsmasq \
    apache2 \
    php \
    python3 \
    python3-pip \
    git

安装

1. 克隆仓库

git clone https://github.com/seu-usuario/aircrack-advanced-mcp.git
cd aircrack-advanced-mcp

2.配置程序Ambiente Python

# Criar ambiente virtual
python3 -m venv venv
source venv/bin/activate

# Instalar dependências MCP
pip install mcp pydantic asyncio

3. 设置 sudo 权限

# Adicionar permissões NOPASSWD para comandos aircrack
echo "$USER ALL=(ALL) NOPASSWD: /usr/bin/airmon-ng, /usr/bin/airodump-ng, /usr/bin/aireplay-ng, /usr/bin/reaver, /usr/bin/wash, /usr/bin/hostapd, /usr/bin/dnsmasq" | sudo tee /etc/sudoers.d/aircrack-mcp

4. 创建目录结构

mkdir -p data/{captures,wordlists,hashcat}
touch data/authorization.txt
echo "Authorized for pentesting" > data/authorization.txt

5.验证汽车接口WiFi

# Listar interfaces disponíveis
iwconfig

# Verificar se suporta modo monitor
sudo airmon-ng

在 Claude.ai 上设置

1. 访问 MCP 设置

  1. 打开 克劳德·艾
  2. 伊雷姆 设置 → 回顾
  3. 点击 连接 MCP 服务器

2. 设置本地服务器

{
  "mcpServers": {
    "aircrack-advanced-mcp": {
      "command": "/caminho/para/venv/bin/python",
      "args": ["/caminho/para/aircrack_advanced_mcp_server.py"],
      "env": {
        "PENTEST_AUTH_FILE": "/caminho/para/data/authorization.txt",
        "PENTEST_CAPTURE_DIR": "/caminho/para/data/captures",
        "PENTEST_WORDLIST_DIR": "/caminho/para/data/wordlists"
      }
    }
  }
}

3. 备用配置文件

创建 ~/.config/claude-mcp/config.json:

{
  "aircrack-advanced-mcp": {
    "command": "python3",
    "args": ["aircrack_advanced_mcp_server.py"],
    "cwd": "/caminho/para/projeto"
  }
}

基本用途

1. 启动服务器

# Ativar ambiente virtual
source venv/bin/activate

# Executar servidor MCP
python3 aircrack_advanced_mcp_server.py

2. Claude中可用的命令

界面管理

airmon_start interface=wlan1
airmon_stop interface=wlan1mon

扫描重新设计

airodump_scan interface=wlan1mon duration=15
airodump_scan interface=wlan1mon channel=6 duration=10
wash_scan interface=wlan1mon duration=30

握手队长

airodump_target interface=wlan1mon bssid=XX:XX:XX:XX:XX:XX channel=6 duration=60

攻击 （仅限自有网络）

aireplay_deauth interface=wlan1mon bssid=XX:XX:XX:XX:XX:XX count=5
reaver_attack interface=wlan1mon bssid=XX:XX:XX:XX:XX:XX channel=6

捕获分析

aircrack_crack capture_file=/caminho/para/arquivo.cap
list_sessions
system_status

高级功能

审计报告

服务器会自动生成检测到的网络的详细报告，包括：

  • 按渠道进行安全分析
  • 制造商分布
  • 易受攻击的网络（启用 WPS）
  • 安全建议
  • 信号功率统计

Hashcat集成

支持捕获的高级握手分析：

  • 自动转换为 hashcat 格式
  • 使用wordlists进行粗力测试
  • 密码模式分析

项目结构

aircrack-advanced-mcp/
├── aircrack_advanced_mcp_server.py    # Servidor MCP principal
├── data/
│   ├── authorization.txt              # Arquivo de autorização
│   ├── captures/                      # Capturas .cap/.pcap
│   ├── wordlists/                     # Wordlists para cracking
│   └── hashcat/                       # Arquivos hashcat
├── venv/                              # Ambiente virtual Python
├── README.md                          # Este arquivo
├── LICENSE                            # Licença do projeto
└── requirements.txt                   # Dependências Python

故障排除

问题：接口无法进入监视器模式

# Verificar se está sendo usada
sudo airmon-ng check kill

# Verificar driver
lsusb | grep -i wireless
dmesg | grep -i wifi

问题：sudo 权限被拒绝

# Verificar se sudoers foi configurado corretamente
sudo visudo -f /etc/sudoers.d/aircrack-mcp

# Testar comando sudo específico
sudo -n airmon-ng

# Se falhar, reconfigurar permissões
echo "$USER ALL=(ALL) NOPASSWD: /usr/bin/airmon-ng, /usr/bin/airodump-ng, /usr/bin/aireplay-ng, /usr/bin/reaver, /usr/bin/wash, /usr/sbin/airmon-ng, /bin/timeout, /usr/bin/timeout" | sudo tee /etc/sudoers.d/aircrack-mcp

问题：MCP 无法连接

# Verificar se servidor está rodando
python3 aircrack_advanced_mcp_server.py

# Verificar configuração do Claude.ai
# Caminho correto para venv/bin/python
# Args corretos para o script

# Verificar logs
tail -f data/captures/pentest_activity.log

问题：命令超时

# Verificar processos interferentes
ps aux | grep -E "(NetworkManager|wpa_supplicant)"

# Verificar interface
iwconfig wlan1

# Verificar se permissões sudo estão funcionando
sudo -n timeout 5 airodump-ng --help

问题：“找不到授权文件”

# Verificar se arquivo existe
ls -la data/authorization.txt

# Criar arquivo se necessário
echo "Authorized for pentesting" > data/authorization.txt

# Verificar variável de ambiente
echo $PENTEST_AUTH_FILE

开发

添加新工具

  1. 添加工具到 handle_list_tools()
  2. 在实现逻辑 handle_call_tool()
  3. 更新文档

新工具示例

Tool(
    name="nova_ferramenta",
    description="Descrição da ferramenta",
    inputSchema={
        "type": "object",
        "properties": {
            "parametro": {
                "type": "string",
                "description": "Descrição do parâmetro"
            }
        },
        "required": ["parametro"]
    }
)

贡献

  1. 分叉工程
  2. 为您的功能创建一个分支 （git checkout -b feature/nova-funcionalidade)
  3. 提交您的更改（git commit -am 'Adiciona nova funcionalidade')
  4. 推动一个分支(git push origin feature/nova-funcionalidade)
  5. 打开 Pull Request

安全

推荐实践

  • 仅在隔离/受控环境中运行
  • 始终使用VPN/代理进行测试
  • 保持详细的活动日志
  • 遵守当地网络安全法律

责任

  • 用户对使用此工具负全部责任。
  • 对于不当或非法使用，我们概不负责。
  • 始终尊重第三方的隐私和财产

许可证

MIT License - 查看文件 许可证 为了细节。

支持

如有疑问、问题或贡献：

致谢

  • Aircrack-ng 团队通过工具包
  • MCP 协议 Anthropic
  • 网络安全社区

免责声明本工具以“现状”提供，用于教育和研究目的。负责任地使用，始终在合法范围内。

相关 MCP