Skip to content

v0.1.1

Choose a tag to compare

@avvocati-e-mac avvocati-e-mac released this 29 Aug 12:23
· 8 commits to main since this release

Correzione: i messaggi d'errore non arrivavano più muti al modello

Un bug reale, trovato provando il server a mano da Claude Desktop durante
un'avaria vera di Normattiva: l'SDK MCP trattava come crash silenzioso
qualunque errore che non fosse una sua ToolError, quindi il modello
vedeva solo "Error executing tool <nome>" invece del messaggio scritto
apposta (es. "Normattiva è stata sospesa dopo guasti ripetuti"). Nella
prova reale questo ha portato il modello a offrire il testo di un
articolo a memoria, come ripiego — proprio il rischio che il progetto
esiste per evitare.

Ogni strumento MCP converte ora ogni eccezione in ToolError prima che
esca dal server, così il messaggio arriva sempre leggibile. Verificato
di nuovo con Claude Desktop e con opencode/DeepSeek v4 flash: l'errore
arriva col testo vero, nessuna ricostruzione a memoria.

Aggiunge anche: le istruzioni consegnate al modello ora spiegano come
distinguere un'avaria vera da un problema di rete locale (norm doctor,
provare da un'altra rete), e il README è completo (installazione, uso,
collegamento a un assistente MCP, cosa aspettarsi da un'avaria).

Installazione con uv

Da questo pacchetto (i due file allegati a questa release):

uv tool install normattiva_mcp-0.1.1-py3-none-any.whl

installa i comandi norm e norm-mcp in ~/.local/bin. Per restare
sincronizzati col sorgente durante lo sviluppo, clonare il repository e
usare invece:

uv tool install --editable .

Verifica dopo l'installazione:

norm --version   # deve stampare 0.1.1
norm fonti "codice civile"