🛡️ ESP32-CYD Wi-Fi Analyzer MCP

ESP32 Cheap Yellow Display (CYD) und Model Context Protocol (MCP) nutzendes, KI-gestütztes Cyber-Sicherheits-Analysegerät, das umliegende Wi-Fi-Netzwerke scannt, Sicherheitslücken analysiert und über das 2,8-Zoll-TFT-Display sowie die RGB-LED auf der Hardware visuelle Rückmeldungen gibt.

🌟 Funktionen

• End-to-End-KI-Integration: Bidirektionale Kommunikation über das Model Context Protocol (MCP) mit Claude Desktop oder jedem kompatiblen LLM-Client.

• Intelligente Bedrohungsanalyse: Erkennung von unverschlüsselten (OPEN) Netzwerken, schwach verschlüsselten (WEP) Zugangspunkten sowie gefälschten/duplizierten Netzwerken (Evil Twin / Rogue AP).

• Visuelles Status- und Alarmpanel: Dynamische Statuskarten auf dem 320x240-TFT-Display (Gelb: Scan läuft, Grün: Sicher, Rot: Sicherheitsbedrohung).

• Aktive Hardwaresteuerung: Farbwechselnde RGB-LED (Active-Low-Treiber) je nach Bedrohungsstufe.

• Selbstheilende Verbindung (Self-Healing): Python-Seriellport-Manager, der bei Ein- und Ausstecken des USB-Kabels nicht abstürzt und sich automatisch wieder verbindet.

Related MCP server: Wireshark MCP Server

🏗️ Systemarchitektur

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

📁 Projektverzeichnisstruktur

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

🔌 Hardware- und Pinout-Konfiguration (ESP32-2432S028R)

🚀 Installationsschritte

Schritt 1: ESP32-Firmware-Installation

1. Installieren Sie die Arduino IDE auf Ihrem Computer.

2. Öffnen Sie in der Arduino IDE den Bibliotheksverwalter (Library Manager) und installieren Sie die folgenden Bibliotheken:

   • TFT_eSPI (Bodmer)

   • ArduinoJson (Benoit Blanchon – v6 oder v7 wird unterstützt)

3. Kopieren Sie die Datei firmware/User_Setup.h und ersetzen Sie die Datei Belgeler/Arduino/libraries/TFT_eSPI/User_Setup.h auf Ihrem Computer.

4. Öffnen Sie die Datei firmware/cyd_wifi_sniffer/cyd_wifi_sniffer.ino mit der Arduino IDE.

5. Wählen Sie als Board ESP32 Dev Module und als Port den COM-Port, an dem Ihr Gerät angeschlossen ist (z. B. COM3), und klicken Sie auf die Schaltfläche Hochladen (Upload).

6. Nach erfolgreichem Upload erscheint auf dem Display die blaue Meldung "SISTEM HAZIR" (System bereit).

Schritt 2: Python-MCP-Server-Installation

1. Stellen Sie sicher, dass Python 3.10 oder eine neuere Version installiert ist.

2. Installieren Sie die erforderlichen Bibliotheken:

   pip install -r requirements.txt

Schritt 3: Claude Desktop-Konfiguration

1. Installieren Sie die Claude Desktop-App.

2. Öffnen Sie die Datei AppData/Roaming/Claude/claude_desktop_config.json (erstellen Sie sie, falls nicht vorhanden) und bearbeiten Sie sie wie folgt:

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

3. Schließen Sie Claude Desktop vollständig und starten Sie es neu.

💬 Verwendung und Beispiel-Prompts

Öffnen Sie einen neuen Chat in Claude Desktop und steuern Sie das Gerät direkt durch Sprechen:

• Port finden:

  "Können Sie mir die aktiven Ports auf meinem Computer anzeigen?"

• Wi-Fi-Scan:

  "Scannen Sie mit meinem Gerät an COM3 die umliegenden Wi-Fi-Netzwerke."

• Cyber-Sicherheitsanalyse und Alarmauslösung:

  "Analysieren Sie die gefundenen Netzwerke. Wenn Sie unverschlüsselte oder verdächtige Netzwerke entdecken, erklären Sie, was es ist, und senden Sie einen Sicherheitsalarm in roter Farbe an das Display des Geräts."

• Display zurücksetzen:

  "Setzen Sie das Display auf den Normalzustand zurück und schalten Sie die LED grün."

🛠️ Unterstützte LLM-Modelle

Da dieses Projekt das standardmäßige Model Context Protocol (MCP) verwendet, ist es mit allen folgenden Systemen kompatibel:

• Claude Desktop (Empfohlen): Claude 3.5 Sonnet / Claude 5 Sonnet (Native MCP-Client)

• Cursor IDE: Kann über Cursor-Einstellungen -> MCP-Menü integriert werden.

• VS Code (Cline / Roo Code): Kann mit GPT-4o, Gemini 1.5 Pro, Llama-3 oder Claude-Modellen verwendet werden.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Details finden Sie in der Datei LICENSE.