Skip to main content
Glama
marlonkipson95

LUZMCP

by marlonkipson95
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

💡 LUZMCP — Sistema IoT com MCP Server & PWA

Firebase Hosting Wokwi Simulator Python React Vite Model Context Protocol

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
    (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)
    (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.

Related MCP server: Home Assistant MCP Server

🏗️ Arquitetura do Sistema

┌─────────────────────────────────────────────────────────┐
│                       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, programado em MicroPython com comunicação HTTP via urequests.

  • Backend: Python / Flask hospedado no PythonAnywhere, 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

.
├── 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)

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

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp2mqtt

    mcp2everything
    A
    license
    B
    quality
    D
    maintenance
    Links IoT devices to AI large models using the MCP and MQTT protocols, enabling natural language control, real-time AI responses, and complex instruction execution for interconnected IoT devices.
    3
    371
    MIT

  • Philips Hue MCP Service

    plwp
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables control of Philips Hue lights through the Model Context Protocol, providing tools for turning lights on/off, setting brightness and color, and retrieving light status.
    1
    Apache 2.0