Matricola
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CMMS_DB_URL | Yes | Indirizzo del database in lettura, in formato SQLAlchemy (es. sqlite:///cmms.db, postgresql+psycopg://...) | |
| CMMS_WRITE_URL | No | Database per la scrittura degli ordini in bozza; se assente si usa CMMS_DB_URL | |
| MATRICOLA_HOST | No | Indirizzo in modalità HTTP (predefinito: 127.0.0.1) | 127.0.0.1 |
| MATRICOLA_PORT | No | Porta in modalità HTTP (predefinita: 8000) | 8000 |
| MATRICOLA_ROOTS | No | Cartelle consentite da usare se l'applicazione non le fornisce (separate da ':') | |
| MATRICOLA_AUDIT_LOG | No | File del registro delle richieste (predefinito: audit.jsonl) | audit.jsonl |
| MATRICOLA_STATELESS | No | 1 per la modalità HTTP senza sessione | |
| MATRICOLA_TRANSPORT | No | stdio (predefinito) oppure streamable-http | stdio |
| MATRICOLA_REPORT_DIR | No | Cartella di destinazione dei report (predefinita: Report) | Report |
| MATRICOLA_JSON_RESPONSE | No | 1 per risposte HTTP in formato JSON unico, senza streaming | |
| MATRICOLA_TIMEOUT_CLIENT | No | Secondi di attesa per le richieste verso l'applicazione (predefinito: 60) | 60 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_rootsA | Elenca le cartelle consultabili: manuali di service, avvisi di sicurezza (FSN), report. |
| read_dirB | Elenca il contenuto di una cartella. Funziona solo dentro i roots. |
| cerca_apparecchiB | Cerca apparecchiature in inventario. Restituisce al massimo 50 righe. |
| scadenzeB | Attività programmate non ancora eseguite: già scadute oppure in scadenza entro N giorni. |
| apparecchi_coinvoltiB | Confronta i seriali di un avviso di sicurezza (FSN) con l'inventario. Non dichiara mai 'nessun apparecchio coinvolto' senza mostrare cosa è stato controllato. |
| riassumi_avvisoA | Estrae i dati operativi da un avviso di sicurezza (FSN). Il risultato è una BOZZA da verificare sull'originale: non sostituisce la lettura dell'avviso da parte dell'ingegnere clinico. |
| report_conformitaB | Calcola, per reparto e tipo di attività, quante attività programmate sono state eseguite in tempo, in ritardo o non eseguite, e salva un CSV nella cartella Report. |
| apri_ordine_lavoroA | Crea un ordine di lavoro in stato BOZZA nel CMMS. Operazione di scrittura: chiedi sempre conferma esplicita prima di usarla. Non approva, non chiude e non assegna interventi: lo fa il tecnico nel CMMS. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool has a distinct purpose: filesystem discovery (list_roots/read_dir), inventory lookup (cerca_apparecchi), scheduling queries (scadenze), FSN cross-checking (apparecchi_coinvolti), reporting, summarization, and work-order creation. The only mild overlaps are list_roots vs read_dir (both filesystem listing at different levels) and cerca_apparecchi vs apparecchi_coinvolti (both hit the inventory, one by free search, one by FSN serial comparison), but the descriptions make the boundaries clear.
Most tools follow a verb_noun pattern (list_roots, read_dir, cerca_apparecchi, riassumi_avviso, apri_ordine_lavoro), but the set mixes English and Italian naming and includes bare noun names (scadenze, report_conformita, apparecchi_coinvolti). It is readable and Italian naming is domain-idiomatic, but the convention is not predictable from name alone.
Eight tools is a well-scoped surface for a clinical-engineering maintenance assistant, with coverage of inventory, FSN alerts, scheduling, compliance reporting, and work-order drafting. No tool appears redundant or gratuitous.
Core workflows are covered end-to-end for the stated domain, with sensible intentional boundaries (work orders are only drafted, approved in the CMMS). The main gap is that read_dir only lists folders and there is no tool to read the contents of a manual or FSN file, leaving a dead end for the 'manuali di service' roots.