mcp-legal-itMaintained

mcp-legal-it

Server MCP + plugin per il diritto italiano

Guida all'installazione per Claude Desktop (Mac e Windows) →

Un avvocato che usa Claude non dovrebbe cercare manualmente testi di legge, ricalcolare interessi o compilare informative privacy a mano. mcp-legal-it e un server Model Context Protocol che mette a disposizione 228 tool di calcolo legale, consultazione normativa, ricerca giurisprudenziale e compliance — tutti accessibili direttamente da Claude.

• Normativa verificata — testi vigenti da Normattiva, EUR-Lex e Brocardi (no allucinazioni)
• Giurisprudenza Cassazione — ricerca full-text e testo sentenze da Italgiure
• Giurisprudenza Tributaria — sentenze CTP/CTR/CGT e Cassazione tributaria da CeRDEF (def.finanze.it)
• Giustizia Amministrativa — sentenze TAR e Consiglio di Stato (giustizia-amministrativa.it)
• Giurisprudenza CGUE — sentenze Corte di Giustizia UE e Tribunale UE via CELLAR SPARQL
• Delibere CONSOB — ricerca e testo integrale dal Bollettino ufficiale
• Calcoli giuridici — interessi, rivalutazione ISTAT, parcelle, contributo unificato, IRPEF, successioni, danni e altro
• GDPR compliance — informative, DPIA, DPA, registro trattamenti, data breach, sanzioni
• 23 skill + 6 agenti — workflow guidati per pareri, cause civili, sinistri, recupero crediti
• Legal Grounding Protocol — hook che verificano che ogni norma citata sia supportata da cite_law()

Prima volta? La guida passo passo porta da zero a Legal IT funzionante in Claude Desktop, su Mac e Windows, anche senza Python installato.

Prerequisito unico: uv. Gestisce automaticamente Python 3.12 e le dipendenze, identico su Windows/macOS/Linux. macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh · Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex". Dopo l'installazione di uv chiudi Claude del tutto (⌘Q su macOS, non basta chiudere la finestra) e riaprilo: un'app già aperta non vede il nuovo PATH. Il primo avvio scarica Python 3.12 + dipendenze (~1 min).

Per il marketplace di Claude Code serve anche git (clona il repository del plugin). Su macOS: xcode-select --install; su Windows: Git for Windows. Il file .mcpb per Claude Desktop non lo richiede.

1. Installa uv (vedi sopra).
2. Scarica legal-it-X.Y.Z.mcpb dall'ultima Release.
3. In Claude Desktop: doppio click sul file — oppure Impostazioni → Estensioni → Impostazioni avanzate → Sviluppatore estensioni → Installa file .mcpb.
4. Riavvia Claude. I 228 tool girano in locale.

Il primo avvio è lento (~1 min: scarica Python 3.12 e le dipendenze) e Claude Desktop può mostrare il server come disconnesso mentre sta ancora scaricando. Attendi un minuto e riavvia Claude: al secondo avvio parte in pochi secondi.

MCP Registry: questo server dichiara la propria identità in server.json (io.github.capazme/mcp-legal-it, trasporto stdio). Il manifest segue lo schema ufficiale del MCP Registry; il marker verificabile per gli aggregatori è mcp-name: io.github.capazme/mcp-legal-it.

claude plugin marketplace add capazme/mcp-legal-it
claude plugin install legal-it@mcp-legal-it

Richiede uv e git (vedi sopra). Il primo avvio può essere lento: vedi la tabella qui sotto.

Al momento non esiste un connettore supportato per claude.ai web o mobile. Il server gira in locale (stdio): le app web e mobile non possono avviarlo, e il plugin non è installabile da lì. Usa Claude Desktop (.mcpb) o Claude Code.

Ogni Release pubblica, oltre al .mcpb, anche legal-it-plugin-X.Y.Z.zip (generato da scripts/build-plugin.sh): una copia autonoma del plugin per Claude Code — skill, comandi, agenti, hook e codice del server — pensata per chi non può usare il marketplace (per esempio senza git). Si carica, per la sola sessione, con claude --plugin-dir legal-it-plugin-X.Y.Z.zip (accetta lo zip o la cartella estratta). Al primo avvio serve comunque la rete: uv scarica Python e le dipendenze. Non è un file da caricare in Claude Desktop (per quello c'è il .mcpb) né in claude.ai.

Ogni Release pubblica anche legal-it-skills-X.Y.Z.zip: le 23 skill in formato .zip, una per file, da caricare su claude.ai (Impostazioni → Funzionalità → Skill). Senza il server MCP le skill che usano gli strumenti di Legal IT non hanno i dati: servono soprattutto come guida di metodo.

docker build -t mcp-legal-it .
docker run -p 8000:8000 mcp-legal-it    # Streamable HTTP su porta 8000, endpoint /mcp

Client MCP:

{
  "mcpServers": {
    "legal-it": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Il pacchetto espone il comando mcp-legal-it (stdio di default; MCP_TRANSPORT=http|sse con MCP_HOST, MCP_PORT, MCP_PATH):

uvx --from git+https://github.com/capazme/mcp-legal-it@main mcp-legal-it

Il server dichiara la propria versione ai client MCP (serverInfo.version). Le release vanno agganciate a un tag (@vX.Y.Z) invece che a @main.

git clone https://github.com/capazme/mcp-legal-it
cd mcp-legal-it
python -m venv .venv && source .venv/bin/activate
pip install -e .

Configurazione in claude_desktop_config.json:

{
  "mcpServers": {
    "legal-it": {
      "command": "/path/to/.venv/bin/python",
      "args": ["/path/to/mcp-legal-it/run_server.py"]
    }
  }
}

Invocabili con /legal-it:<nome> o attivati automaticamente da Claude in base al contesto.

La skill genera-atto supporta 100 modelli in 10 categorie. Il workflow: identificazione tipo atto → raccolta campi obbligatori → calcoli automatici (CU, interessi, parcelle) → generazione → verifica norme con cite_law → output con checklist allegati.

Due tool calcolano sotto una disciplina che non regola più i casi nuovi e servono solo per i casi residuali che ancora governa: termini_183_190_cpc (memorie ex artt. 183 co. 6 e 190 c.p.c. nel testo anteriore alla Riforma Cartabia, per le cause iscritte a ruolo prima del 28/02/2023) ed equo_indennizzo (DPR 834/1981, per i fatti anteriori al 06/12/2011). Sono marcati con una flag dichiarata una volta nel docstring e applicata in tre punti:

Per impostazione predefinita i tool restano registrati e marcati; LEGAL_PREVIGENTE=off li nasconde del tutto. L'audit (scripts/audit_tool_annotations.py) fallisce se un tool dichiara il regime senza tag o senza wrapper @previgente, o se indica come tool vigente un nome non registrato. Dettagli in src/lib/_regime.py.

Il plugin include hook che garantiscono l'accuratezza delle citazioni normative:

• Stop hook — verifica che ogni norma citata nella risposta abbia un cite_law() corrispondente

Regole per l'LLM:

git clone https://github.com/capazme/mcp-legal-it
cd mcp-legal-it
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -m "not live"

Vedi CONTRIBUTING.md per la guida completa allo sviluppo.

Contributi benvenuti! Leggi CONTRIBUTING.md per i dettagli su:

• Come aggiungere un nuovo tool (calcolo o con HTTP)
• Pattern _impl + wrapper per la testabilita
• Convenzioni di output (importi, date, precisione)
• Checklist pre-PR

Apache License 2.0 — Copyright 2025-2026 capazme.

I calcoli sono indicativi e non sostituiscono il parere di un professionista abilitato. Verificare sempre l'aggiornamento delle norme.