🏛️ MCP Banca Dati di Merito — Civile

Server MCP (Model Context Protocol) che permette a qualsiasi LLM o sistema compatibile di consultare direttamente la Banca Dati di Merito del Ministero della Giustizia — la banca dati gratuita che raccoglie sentenze, decreti e ordinanze civili dei tribunali italiani.

Compatibile con Claude Desktop, Cursor, Windsurf, Continue, Zed e qualsiasi altro client che supporta il protocollo MCP.

Una volta configurato, puoi chiedere al tuo assistente AI:

"Cerca sentenze del Tribunale di Bologna sulla locazione abitativa degli ultimi due anni"

"Leggi il testo integrale di questa sentenza e dimmi se è rilevante per il mio caso"

"Trova abstract sulla responsabilità medica con precedenti conformi"

L'assistente cercherà, leggerà e analizzerà i provvedimenti per te, direttamente in chat.

Cosa serve prima di iniziare

1. Windows 10/11 (il progetto è testato su Windows — funziona anche su macOS)

2. Un client MCP installato — es. Claude Desktop, Cursor, Windsurf o altro

3. Node.js 20 o superiore — scaricalo da nodejs.org (scegli la versione "LTS")

4. La tua CIE (Carta d'Identità Elettronica) fisica con PIN

5. L'app CieID installata sul tuo smartphone (App Store / Google Play)

6. Un lettore NFC sul telefono (tutti gli smartphone moderni ce l'hanno)

Related MCP server: gov-it-legal-mcp

Installazione

1. Scarica il progetto

Apri un terminale PowerShell: premi Win + R, digita powershell e premi Invio (oppure usa Terminale Windows se lo hai installato). Poi incolla questi comandi uno alla volta:

cd $HOME\Documents        # su macOS: cd ~/Documents
git clone https://github.com/avvocati-e-mac/mcp-bdm-civile.git
cd mcp-bdm-civile

Se preferisci il prompt dei comandi (CMD), usa cd %USERPROFILE%\Documents al posto di cd $HOME\Documents.

2. Installa le dipendenze

Sempre nel Terminale, nella cartella del progetto:

npm install
npx playwright install chromium

Questo scarica le librerie necessarie e il browser interno usato dallo strumento. Ci vuole qualche minuto.

3. Esegui il login con la CIE

Questo passaggio va fatto una sola volta (la sessione dura circa un anno):

node src/auth/save-session.js

Si aprirà un browser. Segui questi passi:

1. Clicca "Accedi" nella homepage della Banca Dati

2. Seleziona "Entra con CIE"

3. Apparirà un QR code — apri l'app CieID sul telefono e scansionalo

4. Avvicina la CIE al telefono (NFC) e inserisci il PIN nell'app

5. Aspetta che il browser torni sulla homepage della Banca Dati

6. Torna nel Terminale e premi Invio

Se vedi ✅ Sessione verificata, hai completato il login con successo.

4. Configura il tuo client MCP

Trova il percorso assoluto del file src/server.js nella cartella del progetto.

Su Windows (PowerShell) incolla questo comando:

(Resolve-Path .\src\server.js).Path

In alternativa, apri la cartella del progetto in Esplora file e copia il percorso dalla barra degli indirizzi, poi aggiungi \src\server.js alla fine.

Su macOS (Terminale) incolla invece:

echo "$(pwd)/src/server.js"

Copia l'output (es. C:\Users\tuonome\mcp-bdm-civile\src\server.js su Windows, oppure /Users/tuonome/Documents/mcp-bdm-civile/src/server.js su macOS).

Poi aggiungi il server alla configurazione del tuo client. Su Windows il blocco sarà così:

{
  "mcpServers": {
    "bdm-civile": {
      "command": "node",
      "args": ["C:\\Users\\tuonome\\mcp-bdm-civile\\src\\server.js"]
    }
  }
}

Su macOS invece:

{
  "mcpServers": {
    "bdm-civile": {
      "command": "node",
      "args": ["/Users/tuonome/Documents/mcp-bdm-civile/src/server.js"]
    }
  }
}

⚠️ Sostituisci il percorso con quello copiato prima.

Dove si trova il file di configurazione a seconda del client:

Se nel file c'era già altro contenuto (altri server MCP), aggiungi solo la parte "bdm-civile": { ... } dentro "mcpServers".

5. Riavvia il client

Chiudi e riapri il tuo client MCP. Gli strumenti della Banca Dati di Merito saranno disponibili nell'interfaccia.

Come si usa

Chiedi normalmente al tuo assistente AI, in italiano. Alcuni esempi:

Ricerca provvedimenti:

• "Cerca sentenze sulla locazione commerciale del distretto di Milano"

• "Trova ordinanze del 2024 del Tribunale di Roma in materia di separazione"

• "Cerca provvedimenti che citano l'articolo 1453 del codice civile"

Lettura provvedimenti:

• "Leggi il testo integrale di questa sentenza: [incolla URL dalla BDP]"

• "Dimmi i metadati di questo provvedimento: giudice, materia, parole chiave"

Abstract e precedenti:

• "Cerca abstract sulla responsabilità del medico"

• "Ci sono precedenti conformi per questo abstract?"

Navigazione archivio:

• "Mostrami i tribunali del distretto di Napoli presenti in archivio"

• "Quali materie sono disponibili per il Tribunale di Torino?"

Utilità:

• "La sessione della Banca Dati è ancora attiva?"

• "Elenca tutte le materie disponibili nella BDP"

Quando la sessione scade

La sessione CIE dura circa un anno. Quando scade, l'assistente risponderà con un messaggio del tipo:

Sessione CIE scaduta. Ferma il server, esegui: npm run save-session, poi riavvia.

Per rinnovarla, apri un terminale (PowerShell o Terminale Windows) nella cartella del progetto e ripeti il login:

cd $HOME\Documents\mcp-bdm-civile     # su macOS: cd ~/Documents/mcp-bdm-civile
node src/auth/save-session.js

Poi riavvia il client MCP.

Domande frequenti

Il browser si apre quando uso il server — è normale? Sì. Il server usa un browser interno in background per navigare la BDP. Alla prima chiamata dopo l'avvio del client, il browser si inizializza e potresti vederlo comparire brevemente nella taskbar (barra delle applicazioni) o nel Dock.

I miei dati sono al sicuro? Il server accede alla BDP usando le tue credenziali CIE, esattamente come faresti tu nel browser. Non invia nulla a server esterni — tutto rimane sul tuo computer e sulla BDP del Ministero.

Posso usarlo senza CIE? No. La BDP richiede autenticazione con CIE livello 3. Senza login non è possibile accedere ai provvedimenti.

Funziona su Windows? Sì, il progetto è testato su Windows 10/11 (e funziona anche su macOS).

Il client non trova i tool della BDP dopo la configurazione — cosa faccio? Verifica che il percorso nel file di configurazione sia corretto e che il file sia salvato nella posizione giusta per il tuo client. Poi riavvia completamente il client.

Struttura del progetto

mcp-bdm-civile/
├── src/
│   ├── server.js              punto di ingresso del server MCP
│   ├── auth/
│   │   ├── save-session.js    script di login CIE
│   │   └── session-manager.js carica la sessione salvata
│   ├── browser/               gestione del browser interno
│   └── tools/                 gli 11 strumenti disponibili
├── spec/                      documentazione tecnica dei selettori DOM
├── sessioni/                  diario delle sessioni di sviluppo
├── CLAUDE.md                  istruzioni tecniche per lo sviluppo
└── GUIDA.md                   guida tecnica all'architettura

Licenza e crediti

Sviluppato da @avvocati-e-mac.

I dati provengono dalla Banca Dati di Merito del Ministero della Giustizia — accesso gratuito previa autenticazione CIE.