🛡️ ESP32-CYD Wi-Fi Analyzer MCP

ESP32 Cheap Yellow Display (CYD) and Model Context Protocol (MCP) are used to create an AI-powered cybersecurity analysis device that scans nearby Wi-Fi networks, analyzes security vulnerabilities, and provides visual feedback through the 2.8-inch TFT display and RGB LED on the hardware.

🌟 Features

• End-to-End AI Integration: Bidirectional communication with Claude Desktop or any compatible LLM client via the Model Context Protocol (MCP).

• Smart Threat Analysis: Detection of unencrypted (OPEN) networks, weakly encrypted (WEP) access points, and fake/clone networks (Evil Twin / Rogue AP).

• Visual Status and Alert Panel: Dynamic status cards on the 320x240 TFT display (Yellow: Scanning, Green: Secure, Red: Security Threat).

• Active Hardware Control: Built-in RGB LED (Active-Low driver) that changes color based on threat level.

• Self-Healing Connection: Python serial port manager that does not lock up and automatically reconnects when the USB cable is unplugged and plugged back in.

Related MCP server: Wireshark MCP Server

🏗️ System Architecture

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

📁 Project Directory Structure

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 and Pinout Configuration (ESP32-2432S028R)

🚀 Installation Steps

Step 1: ESP32 Firmware Installation

1. Install Arduino IDE on your computer.

2. Open the Library Manager within Arduino IDE and install the following libraries:

   • TFT_eSPI (Bodmer)

   • ArduinoJson (Benoit Blanchon - v6 or v7 supported)

3. Copy the firmware/User_Setup.h file and replace the Documents/Arduino/libraries/TFT_eSPI/User_Setup.h file on your computer with it.

4. Open the firmware/cyd_wifi_sniffer/cyd_wifi_sniffer.ino file with Arduino IDE.

5. Select ESP32 Dev Module as the board, choose the COM port your device is connected to (e.g., COM3) as the port, and click the Upload button.

6. When the upload is complete, a blue "SISTEM HAZIR" message will appear on the screen.

Step 2: Python MCP Server Installation

1. Make sure Python 3.10 or a newer version is installed.

2. Install the required libraries:

   pip install -r requirements.txt

Step 3: Claude Desktop Configuration

1. Install the Claude Desktop application.

2. Open the AppData/Roaming/Claude/claude_desktop_config.json file (create it if it doesn't exist) and edit it as follows:

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

3. Completely close and restart the Claude Desktop application.

💬 Usage and Example Prompts

Open a new chat in Claude Desktop and manage the device by speaking directly:

• Finding Ports:

  "Can you list the active ports on my computer?"

• Wi-Fi Scanning:

  "Scan the Wi-Fi networks around me with the device on COM3."

• Cybersecurity Analysis and Alarm Triggering:

  "Examine the networks you found. If you detect unencrypted or suspicious networks, explain what they are and send a red security alarm to the device's screen."

• Resetting the Screen:

  "Return the screen to normal and turn the LED green."

🛠️ Supported LLM Models

This project uses the standard Model Context Protocol (MCP), so it is compatible with all the following systems:

• Claude Desktop (Recommended): Claude 3.5 Sonnet / Claude 5 Sonnet (Native MCP client)

• Cursor IDE: Can be integrated via Cursor Settings -> MCP menu.

• VS Code (Cline / Roo Code): Can be used with GPT-4o, Gemini 1.5 Pro, Llama-3, or Claude models.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.