MCT2032 - Mini Cyber Tool 2032

A portable cybersecurity toolkit that fits in your pocket

Web Installer • Documentation • Report Bug • Request Feature

🎯 About The Project

MCT2032 transforms the Waveshare ESP32-S3-LCD-1.47 into a powerful cybersecurity research tool. With its circular display, dual-core processor, and wireless capabilities, it's the perfect platform for security professionals and enthusiasts.

Why "Mini"? At just 50mm × 38.5mm and $12.99, MCT2032 proves that powerful security tools don't need to be expensive or bulky. It's the most affordable entry point into professional WiFi security research.

🛡️ Hardware: Waveshare ESP32-S3-LCD-1.47

Why This Device?

The Waveshare ESP32-S3-LCD-1.47 is the first of its kind to be transformed into a dedicated cybersecurity tool. While others focus on generic IoT projects, we're pioneering its use in the security sector.

Technical Specifications

Component	Specification
Processor	ESP32-S3 Dual-core Xtensa LX7 @ 240MHz
Memory	512KB SRAM, 384KB ROM, 16MB Flash, 8MB PSRAM
Display	1.47" Round LCD (172×320, 262K colors, ST7789 driver)
Wireless	2.4GHz WiFi (802.11 b/g/n), Bluetooth 5.0 LE
Storage	MicroSD card slot (SPI)
USB	Type-C with native USB support
GPIO	14 programmable pins
Extras	RGB LED, BOOT/RESET buttons
Power	5V via USB-C, 3.3V operating
Size	50.0mm × 38.5mm (pocket-sized!)
Price	~$12.99 (Incredible value!)

Why It's Perfect for Cybersecurity

🚀 Dual-Core Power: Run packet capture on one core, UI on the other
📡 Integrated Antenna: No external antenna needed for WiFi/BLE operations
💾 Massive Memory: 8MB PSRAM handles large packet buffers
🎨 Circular Display: Unique form factor with custom cyberpunk UI
🔌 Native USB: Direct serial communication, no adapter needed
💰 Affordable: Professional features at hobbyist price

✨ Current Features

🟢 Working

✅ WiFi Scanner - Comprehensive network analysis
- SSID, BSSID, Channel, RSSI, Security detection
- Hidden network discovery
- Channel-specific scanning
- Real-time signal strength indicators
✅ Stop Scan - Interrupt long-running scans
✅ BLE Admin Console - Full device control via Bluetooth
- Cross-platform Python application
- Dark hacker-themed UI
- Real-time data visualization
✅ Chunked Data Transfer - Handle large datasets over BLE
✅ Web Installer - Browser-based firmware flashing
✅ Circular UI - Custom LVGL interface with animations

🟡 Framework Ready (Not Active)

🔨 Packet Monitor (promiscuous mode)
🔨 Deauth Attack capability
🔨 Beacon Spam framework
🔨 PCAP capture infrastructure
🔨 Evil Portal framework

🐛 Known Issues

🔴 BLE Scanning: Not implemented (returns "Not implemented yet")
🟡 SD Card: Not tested, may need initialization
🟡 Battery Monitor: Returns dummy value (100%)
🟡 Advanced Features: Framework only, not functional yet

📋 TODO List

High Priority

Implement BLE scanning functionality
Add SD card support for PCAP storage
Implement packet injection for deauth
Create settings persistence system
Add OTA update capability

Medium Priority

Low Priority

Custom boot logo
Sound effects via piezo
RGB LED patterns for status
Power saving modes

🗺️ Roadmap

Phase 1: Foundation (Current)

✅ Basic WiFi scanning
✅ BLE communication
✅ Admin console
✅ Web installer

Phase 2: Security Tools (Q1 2025)

🎯 Active packet monitoring
🎯 Deauth attack implementation
🎯 Beacon spam activation
🎯 PCAP file creation

Phase 3: Advanced Features (Q2 2025)

🎯 Evil Portal deployment
🎯 WPS vulnerability scanner
🎯 Bluetooth device scanner
🎯 Mesh network analysis

Phase 4: Professional Tools (Q3 2025)

🎯 Custom packet crafting
🎯 Protocol fuzzing
🎯 MITM capabilities
🎯 Network mapping visualization

Phase 5: Integration (Q4 2025)

🎯 Cloud dashboard
🎯 Multi-device coordination
🎯 AI-powered threat detection
🎯 Automated penetration testing

🤝 Contributing

We need YOUR help to make MCT2032 the ultimate pocket cyber tool!

How You Can Help

🐍 Python Developers

Enhance the admin console UI
Add data visualization features
Implement export formats
Create automated testing scripts

🔧 C++ Developers

Implement BLE scanning
Optimize packet capture
Add new attack vectors
Improve memory management

🎨 UI/UX Designers

Create custom icons
Design new UI themes
Improve user workflows
Create animation effects

📚 Documentation Writers

Write tutorials
Create video guides
Translate documentation
Document API endpoints

🧪 Security Researchers

Test attack implementations
Find vulnerabilities
Suggest new features
Create PoC exploits

Getting Started

Fork the repository
Check our Issues page
Pick a task from the TODO list
Create a feature branch
Submit a Pull Request

Development Setup

# Clone the repo
git clone https://github.com/webdevtodayjason/mct2032.git
cd mct2032

# Set up firmware development
cd mct2032-firmware
pio lib install

# Set up admin console
cd ../mct2032-admin
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

🚀 Quick Start

Option 1: Web Installer (Recommended)

Visit https://webdevtodayjason.github.io/mct2032/
Connect your ESP32-S3 device via USB
Click "Install" and follow the prompts
Download and run the admin console

Option 2: Build from Source

# Clone the repository
git clone https://github.com/webdevtodayjason/mct2032.git
cd mct2032

# Build and upload firmware
cd mct2032-firmware
pio run -t upload

# Run admin console
cd ../mct2032-admin
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
python main.py

UI Design

ESP32 Display

Background: Deep dark blue (#0a0e27, #0f0f23)
Border: Purple gradient with glow effect (#8b5cf6)
Status Text: Terminal green (#00ff41)
Mode Indicators: Color-coded (Idle=Green, Scanning=Cyan, Attack=Red, etc.)
Connection Status: Visual indicator (Red=Disconnected, Green=Connected)

Admin Console

Framework: Python Tkinter with CustomTkinter
Theme: Dark hacker aesthetic matching the device
Features:
- Real-time WiFi network display with signal strength indicators
- Console log with timestamp
- Tabbed interface for different functions
- Stop scan functionality

Technical Details

Communication Protocol

Transport: Bluetooth LE with custom GATT service
Chunking: Automatic chunking for responses > 512 bytes
Format: JSON-based command/response protocol
Commands: SCAN_WIFI, SCAN_BLE, GET_STATUS, and more

Security Features

Passive Scanning: Non-intrusive network discovery
Channel Hopping: Monitor multiple channels
Packet Analysis: Detailed frame type statistics
Research Mode: Advanced features for security testing

Development with Claude Code

This project is configured for Claude Code. See CLAUDE.md for detailed instructions.

Key Points:

Always update tasks in Dart before starting work
Use Context7 for latest documentation
Follow the dark hacker theme with purple gradients
Test with Playwright
Log all development activities

Project Structure

mct2032/
├── mct2032-firmware/     # ESP32 firmware (PlatformIO)
│   ├── include/          # Header files
│   ├── src/              # Source files
│   └── platformio.ini    # Build configuration
├── mct2032-admin/        # Python admin console
│   ├── mct2032_admin/    # Package source
│   └── requirements.txt  # Python dependencies
├── web-installer/        # Web-based firmware installer
├── docs/                 # Additional documentation
├── scripts/              # Build and release scripts
├── .claude/              # Claude Code configuration
└── logs/                 # Development logs

Building from Source

Firmware

cd mct2032-firmware
pio run                    # Build
pio run -t upload          # Upload to device
pio device monitor         # Serial monitor

Admin Console

cd mct2032-admin
pip install -r requirements.txt
python main.py

Contributing

Check Dart for open tasks
Follow the established code style
Test all changes thoroughly
Update documentation as needed

📸 Screenshots

_{Compact Design}

_{Scanning Mode}

_{Admin Console}

🏆 Why MCT2032?

Compared to Other Tools

Feature	MCT2032	Flipper Zero	WiFi Pineapple	Proxmark3
Price	$12.99	$169 (+$29 for WiFi)	$99-$399	$300+
WiFi Attacks	✅ Native	⚠️ With addon	✅ Specialized	❌
Bluetooth	✅ BLE 5.0	✅ BLE	❌	❌
Display	✅ Color LCD	✅ Monochrome	❌ Web UI	❌
Sub-GHz Radio	❌	✅	❌	❌
NFC/RFID	❌	✅	❌	✅ Specialized
Infrared	❌	✅	❌	❌
Open Source	✅	✅	✅	✅
Pocket Size	✅ (50mm)	✅	⚠️ Varies	✅
Web Installer	✅	❌	❌	❌
Battery	USB-C Power	✅ Built-in	⚠️ Varies	USB Power
Target Users	WiFi/BLE Research	Multi-Protocol	WiFi Pentesting	RFID Research

🛠️ Technical Architecture

graph TD
    A[ESP32-S3] -->|SPI| B[1.47" LCD]
    A -->|WiFi| C[2.4GHz Networks]
    A -->|BLE| D[Admin Console]
    A -->|GPIO| E[RGB LED]
    A -->|SPI| F[SD Card]
    D -->|Python| G[Cross-Platform GUI]
    C -->|Scan| H[Network Data]
    H -->|JSON| D

📚 Documentation

🌟 Community

💬 Discord Server (Coming Soon)
🐦 Twitter Updates (Coming Soon)
📺 YouTube Tutorials (Coming Soon)
📝 Blog (Coming Soon)

🙏 Acknowledgments

Inspired by ESP32 Marauder and Bruce
Built with ESP-IDF and PlatformIO
UI powered by LVGL
Admin console uses CustomTkinter

⚖️ Legal Disclaimer

IMPORTANT: This tool is designed for legitimate security research and testing on networks you own or have explicit permission to test.

⚠️ Unauthorized network scanning or attacks are illegal
⚠️ Users are responsible for complying with all applicable laws
⚠️ We are not responsible for misuse of this tool
✅ Only use on networks you own or have written permission to test

📄 License

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

Made with ❤️ by the MCT2032 Community

If you find this project useful, please consider giving it a ⭐!

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
.claude		.claude
.github/workflows		.github/workflows
docs		docs
firmware		firmware
logs		logs
mct2032-admin		mct2032-admin
mct2032-firmware		mct2032-firmware
releases		releases
scripts		scripts
web-installer		web-installer
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
CREATE_RELEASE.md		CREATE_RELEASE.md
GITHUB_DEPLOYMENT_GUIDE.md		GITHUB_DEPLOYMENT_GUIDE.md
LOCAL_TESTING.md		LOCAL_TESTING.md
README.md		README.md
init-project.py		init-project.py
local-server.py		local-server.py
update-username.sh		update-username.sh

webdevtodayjason/mct2032

Folders and files

Latest commit

History

Repository files navigation

MCT2032 - Mini Cyber Tool 2032

🎯 About The Project

🛡️ Hardware: Waveshare ESP32-S3-LCD-1.47

Why This Device?

Technical Specifications

Why It's Perfect for Cybersecurity

✨ Current Features

🟢 Working

🟡 Framework Ready (Not Active)

🐛 Known Issues

📋 TODO List

High Priority

Medium Priority

Low Priority

🗺️ Roadmap

Phase 1: Foundation (Current)

Phase 2: Security Tools (Q1 2025)

Phase 3: Advanced Features (Q2 2025)

Phase 4: Professional Tools (Q3 2025)

Phase 5: Integration (Q4 2025)

🤝 Contributing

How You Can Help

🐍 Python Developers

🔧 C++ Developers

🎨 UI/UX Designers

📚 Documentation Writers

🧪 Security Researchers

Getting Started

Development Setup

🚀 Quick Start

Option 1: Web Installer (Recommended)

Option 2: Build from Source

UI Design

ESP32 Display

Admin Console

Technical Details

Communication Protocol

Security Features

Development with Claude Code

Key Points:

Project Structure

Building from Source

Firmware

Admin Console

Contributing

📸 Screenshots

🏆 Why MCT2032?

Compared to Other Tools

🛠️ Technical Architecture

📚 Documentation

🌟 Community

🙏 Acknowledgments

⚖️ Legal Disclaimer

📄 License

Made with ❤️ by the MCT2032 Community

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Languages

Packages