🛡️ ESP32-CYD Wi-Fi Analyzer MCP

ESP32 Cheap Yellow Display (CYD) y Model Context Protocol (MCP) utilizando un dispositivo de análisis de ciberseguridad asistido por inteligencia artificial que escanea redes Wi-Fi cercanas, analiza vulnerabilidades y proporciona retroalimentación visual a través de la pantalla TFT de 2.8 pulgadas y el LED RGB del hardware.

🌟 Características

• Integración de IA de extremo a extremo: Comunicación bidireccional con Claude Desktop o cualquier cliente LLM compatible a través del Model Context Protocol (MCP).

• Análisis inteligente de amenazas: Detección de redes abiertas (OPEN), puntos de acceso débilmente cifrados (WEP) y redes falsas/clonadas (Evil Twin / Rogue AP).

• Panel visual de estado y alertas: Tarjetas de estado dinámicas en la pantalla TFT de 320x240 (Amarillo: Escaneando, Verde: Seguro, Rojo: Amenaza de seguridad).

• Control activo del hardware: LED RGB integrado que cambia de color según el nivel de amenaza (controlador Active-Low).

• Conexión auto-reparable (Self-Healing): Gestor de puerto serie Python que no se bloquea y se reconecta automáticamente cuando se desconecta y vuelve a conectar el cable USB.

Related MCP server: Wireshark MCP Server

🏗️ Arquitectura del sistema

flowchart LR
    subgraph AI["Yapay Zeka (Brain)"]
        CLAUDE["Claude Desktop / Cursor\n(Claude 3.5/5 Sonnet)"]
    end

    subgraph MCP["Protokol Köprüsü (Middleware)"]
        SERVER["FastMCP Python Server\n(mcp_serial_server.py)"]
    end

    subgraph HARDWARE["Uç Donanım (Edge Device)"]
        CYD["ESP32 Cheap Yellow Display\n(ESP32-2432S028R)"]
        TFT["2.8' TFT Ekran"]
        LED["Dahili RGB LED"]
        CYD --> TFT
        CYD --> LED
    end

    CLAUDE <-->|JSON-RPC Stdio| SERVER
    SERVER <-->|USB Serial (COM3 / 115200 Baud)| CYD

📁 Estructura del directorio del proyecto

ESP32-CYD-WiFi-Analyzer-MCP/
├── firmware/
│   ├── cyd_wifi_sniffer/
│   │   └── cyd_wifi_sniffer.ino   # ESP32 C++ firmware kodu
│   └── User_Setup.h               # TFT_eSPI kütüphanesi için hazır pin yapılandırması
├── server/
│   └── mcp_serial_server.py       # FastMCP tabanlı Python seri port sunucusu
├── config/
│   └── claude_desktop_config.json.example # Claude Desktop örnek ayar dosyası
├── requirements.txt               # Python bağımlılıkları
├── .gitignore                     # Git yoksayma kuralları
└── README.md                      # Proje dokümantasyonu

🔌 Configuración de hardware y pines (ESP32-2432S028R)

🚀 Pasos de instalación

Paso 1: Instalación del firmware ESP32

1. Instale Arduino IDE en su ordenador.

2. Dentro de Arduino IDE, abra el Administrador de bibliotecas (Library Manager) e instale las siguientes bibliotecas:

   • TFT_eSPI (Bodmer)

   • ArduinoJson (Benoit Blanchon - se admiten v6 o v7)

3. Copie el archivo firmware/User_Setup.h y reemplácelo con el archivo Documentos/Arduino/libraries/TFT_eSPI/User_Setup.h en su ordenador.

4. Abra el archivo firmware/cyd_wifi_sniffer/cyd_wifi_sniffer.ino con Arduino IDE.

5. Seleccione ESP32 Dev Module como placa y el puerto COM al que está conectado su dispositivo (por ejemplo, COM3), luego presione el botón Subir (Upload).

6. Cuando la carga se complete, aparecerá un mensaje azul "SISTEMA LISTO" en la pantalla.

Paso 2: Instalación del servidor Python MCP

1. Asegúrese de tener instalado Python 3.10 o una versión más reciente.

2. Instale las bibliotecas necesarias:

   pip install -r requirements.txt

Paso 3: Configuración de Claude Desktop

1. Instale la aplicación Claude Desktop.

2. Abra el archivo AppData/Roaming/Claude/claude_desktop_config.json (si no existe, créelo) y edítelo de la siguiente manera:

   {
     "mcpServers": {
       "esp32-cyd-sniffer": {
         "command": "python",
         "args": [
           "C:\\path\\to\\your\\repository\\server\\mcp_serial_server.py"
         ]
       }
     }
   }

3. Cierre completamente la aplicación Claude Desktop y reiníciela.

💬 Uso y ejemplos de prompts

Abra un nuevo chat en Claude Desktop y administre el dispositivo hablando directamente:

• Encontrar puerto:

  "¿Puedes listar los puertos activos en mi ordenador?"

• Escaneo Wi-Fi:

  "Escanea las redes Wi-Fi a mi alrededor con el dispositivo en el puerto COM3."

• Análisis de ciberseguridad y activación de alarma:

  "Analiza las redes que encontraste. Si detectas redes abiertas o sospechosas, explica qué son y envía una alarma de seguridad en rojo a la pantalla del dispositivo."

• Restablecer pantalla:

  "Vuelve la pantalla a la normalidad y enciende el LED en verde."

🛠️ Modelos LLM compatibles

Este proyecto utiliza el Model Context Protocol (MCP) estándar, por lo que es compatible con todos los siguientes sistemas:

• Claude Desktop (Recomendado): Claude 3.5 Sonnet / Claude 5 Sonnet (Cliente MCP nativo)

• Cursor IDE: Se puede integrar a través del menú Cursor Settings -> MCP.

• VS Code (Cline / Roo Code): Se puede usar con GPT-4o, Gemini 1.5 Pro, Llama-3 o modelos Claude.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo LICENSE para más detalles.