sede

sistema pubblico delle presenze sviluppato per la nuova sede della Metro Olografix.

questo progetto è ispirato a BITS (Gitlab).

progetto

il progetto è diviso in due parti:

hardware

• ESP32 (S3 consigliato), correttamente testato su Xiao ESP32-S3.
• RGB LED Light Switch momentaneo / 3-6V
• 3 resistenze da 330ohm

Schematic:

il firmware è sviluppato utilizzando il framework ESPHome ed è modificabile qui.

per flashare il firmware sul proprio ESP32 è necessario avviare ESPHome in locale o su una istanza remota, per lanciarlo in locale:

git clone git@github.com:Metro-Olografix/sede.git

cd sede/hardware

docker compose up -d

ora, aprire http://localhost:6052 sul proprio browser e sarà già disponibile pulsante-sede.yaml nella schermata iniziale.

backend

il backend è un semplice web server in Go, espone:

• GET /status: risponde true o false
• POST /toggle: cambia lo stato della sede e ritorna il nuovo stato
• GET /stats: ritorna le statistiche orario con probabilità di trovare la sede aperta o chiusa in base allo storico
• GET /ui: attiva solo se DEBUG=true

per lanciarlo in locale:

git clone git@github.com:Metro-Olografix/sede.git

cd sede/backend

docker build -t sede .

docker run -p 8080:8080 -e DEBUG=true -v ./database:/app/database sede

server MCP

perchè non dare la possibilità agli LLM di sapere se la sede è aperta o chiusa?

configurare Claude Desktop

aggiungere dentro claude_desktop_config.json:

{
  "mcpServers": {
    "mx-sede": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/metro-olografix/sede/mcp:latest"
      ]
    }
  }
}

sviluppo locale

https://modelcontextprotocol.io/quickstart/server#set-up-your-environment