# 💡 LUZMCP — Sistema IoT com MCP Server & PWA

[![Firebase Hosting](https://img.shields.io/badge/Firebase_Hosting-Live-FFCA28?logo=firebase&logoColor=black)](https://projetosapp-f1f85.web.app)
[![Wokwi Simulator](https://img.shields.io/badge/Wokwi-Simulator-007ACC?logo=espressif&logoColor=white)](https://wokwi.com/projects/474785026691994625)
[![Python](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python&logoColor=white)](https://python.org)
[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=black)](https://react.dev)
[![Vite](https://img.shields.io/badge/Vite-5-646CFF?logo=vite&logoColor=white)](https://vitejs.dev)
[![Model Context Protocol](https://img.shields.io/badge/MCP-Protocol-purple)](https://modelcontextprotocol.io/)

Sistema distribuído para monitoramento e controle remoto de lâmpadas/dispositivos IoT em tempo real. A arquitetura conecta um **Progressive Web App (PWA)** moderno, um servidor **MCP (Model Context Protocol)** para integração com Agentes e LLMs, uma **API REST Flask** e um **microcontrolador simulado no Wokwi** executando MicroPython.

---

## 🎮 Demonstração Online (Teste Agora Mesmo)

Você pode testar todo o sistema funcionando ao vivo sem precisar instalar nada:

1. **Abra o Simulador de Hardware**:  
   👉 [Acessar Simulador Wokwi](https://wokwi.com/projects/474785026691994625)  
   *(Clique no botão verde de **Play ▶️** para iniciar a placa e ligar a conexão Wi-Fi).*

2. **Abra o Painel de Controle (PWA)**:  
   👉 [Acessar Painel IoT Control (PWA)](https://projetosapp-f1f85.web.app)  
   *(Funciona no computador e no celular. No celular, você pode selecionar "Adicionar à tela inicial" para instalar como app).*

3. **Interaja com as Lâmpadas**:  
   - Clique no botão de **L1** ➔ O LED Vermelho no pino GP10 acende na simulação.
   - Clique no botão de **L2** ➔ O LED Azul no pino GP11 acende na simulação.
   - Desligue os interruptores no app para apagar as luzes correspondentes.

---

## 🏗️ Arquitetura do Sistema

```text
┌─────────────────────────────────────────────────────────┐
│                       Clientes                          │
│   • PWA no Celular / Computador (Firebase Hosting)      │
│   • Agentes de IA / LLMs (Claude, Gemini, Antigravity)   │
└────────────────────────────┬────────────────────────────┘
                             │
            ┌────────────────┴────────────────┐
            │                                 │
     (Modo IA / Tools)                (Modo Web Direto)
            ▼                                 ▼
┌───────────────────────┐          ┌───────────────────────┐
│    MCP Server (Py)    │          │  API REST Flask (Py)  │
│  Transporte SSE / RPC │─────────►│  (PythonAnywhere)     │
└───────────────────────┘          └───────────┬───────────┘
                                               │
                                      Polling HTTP (1s)
                                               │
                                               ▼
                                   ┌───────────────────────┐
                                   │  Raspberry Pi Pico W  │
                                   │     (MicroPython)     │
                                   └───────────┬───────────┘
                                               │
                                      Pinos GP10 e GP11
                                               │
                                               ▼
                                   ┌───────────────────────┐
                                   │   LEDs L1 (Vermelho)  │
                                   │   LEDs L2 (Azul)      │
                                   └───────────────────────┘
```

---

## 🛠️ Tecnologias Utilizadas

- **Microcontrolador / IoT**: Raspberry Pi Pico W simulado no [Wokwi](https://wokwi.com), programado em **MicroPython** com comunicação HTTP via `urequests`.
- **Backend**: **Python / Flask** hospedado no [PythonAnywhere](https://www.pythonanywhere.com), com suporte a CORS nativo e gerenciamento de estado dos periféricos.
- **Camada MCP**: **Model Context Protocol SDK** (`mcp`), expondo as ferramentas `obter_status_lampadas` e `alterar_status_lampada` via Server-Sent Events (SSE).
- **Frontend / PWA**: **React 19**, **Vite**, **TypeScript**, **Tailwind CSS** e **Lucide Icons**, hospedado no **Firebase Hosting**.

---

## 📁 Estrutura de Diretórios

```text
.
├── app.py                     # API Flask existente com rotas /micro e /comandos
├── mcp_server.py              # MCP Server expondo Tools IoT via protocolo SSE
├── wokwi.txt                  # Código MicroPython para o simulador Wokwi
├── firebase.json              # Configurações de deploy no Firebase Hosting
├── pwa/                       # Aplicação frontend PWA
│   ├── src/
│   │   ├── App.tsx            # Lógica híbrida (MCP + API Direta) e interface
│   │   └── main.tsx           # Ponto de entrada React
│   ├── package.json           # Dependências do frontend
│   └── vite.config.ts         # Configurações de build e proxy local
└── README.md                  # Documentação do projeto
```

---

## 💻 Como Rodar o Projeto Localmente

### 1. Pré-requisitos
- Python 3.10 ou superior instalado.
- Node.js 18 ou superior instalado.

### 2. Rodando o Servidor MCP (Python)
```bash
pip install -r requirements.txt
python mcp_server.py
```
O servidor MCP inicializará ouvindo conexões SSE na porta `8080`.

### 3. Rodando o PWA em Desenvolvimento
```bash
cd pwa
npm install
npm run dev
```
Abra `http://localhost:5173` no seu navegador. O frontend conectará automaticamente ao MCP Server local via proxy `/sse`.

---

## 👨‍💻 Autor

Desenvolvido por **Marlon Kipson**  
- GitHub: [@marlonkipson95](https://github.com/marlonkipson95)  
- Repositório: [marlonkipson95/LUZMCP](https://github.com/marlonkipson95/LUZMCP)