Python |

tei-mcp

Sun, 15 Mar 2026 00:00:00 +0000

tei-mcp: la TEI P5 per gli agenti IA

tei-mcp è un server open source che dà agli assistenti IA per la programmazione un accesso diretto alla specifica . Invece di affidarsi a ciò che ricorda dell’addestramento – da cui esce spesso una marcatura plausibile ma sbagliata – l’IA interroga la specifica in tempo reale.

Funzionalità

Il server analizza l’ODD della TEI P5 ed espone 16 strumenti:

Ricerca di qualunque elemento, classe, macro o modulo per nome, senza distinguere maiuscole e minuscole e con suggerimenti in caso di refuso
Risoluzione degli attributi lungo l’intera gerarchia di classi TEI (locali ed ereditati)
Espansione dei modelli di contenuto in alberi strutturati, con risoluzione di classi e macro
Verifica dell’annidamento: rapporto diretto genitore-figlio, o raggiungibilità ricorsiva con tracciamento del percorso
Validazione dei documenti rispetto alla TEI P5: modelli di contenuto, attributi, liste chiuse di valori, integrità dei riferimenti e avvisi di deprecazione
Validazione di singoli elementi per chi lavora per ritocchi successivi
Caricamento di personalizzazioni ODD per restringere lo schema al sottoinsieme proprio di un progetto
Ricerca in tutti i tipi di entità con espressioni regolari

Installazione

pip install tei-mcp

Oppure si esegue direttamente con:

uvx tei-mcp

Uso

Si aggiunge a qualsiasi client compatibile con MCP (Claude, Cursor, Windsurf ecc.):

{
 "mcpServers": {
 "tei": {
 "command": "uvx",
 "args": ["tei-mcp"]
 }
 }
}

Il codice sorgente e la documentazione sono nel .

Multi-Saxon

Fri, 28 Mar 2025 00:00:00 +0000

Multi-Saxon: trasformazioni XSLT in parallelo per grandi corpora TEI

Multi-Saxon colma una lacuna seria fra gli strumenti di elaborazione XML: esegue in parallelo trasformazioni XSLT 2.0 e 3.0 che LXML, la diffusa libreria XML per Python, non sa gestire. Pensato per grandi collezioni di documenti XML TEI, abbatte i tempi di elaborazione grazie a un’esecuzione parallela efficiente.

Caratteristiche principali

XSLT avanzato: elabora trasformazioni XSLT 2.0 e 3.0, fuori dalla portata di LXML
Elaborazione parallela: la parallelizzazione riduce drasticamente i tempi di trasformazione delle grandi collezioni di documenti
Su misura per la TEI: progettato apposta per i documenti XML della Text Encoding Initiative (TEI)
Prestazioni scalabili: gestisce con efficienza corpora da centinaia a migliaia di documenti
Multipiattaforma: funziona su sistemi operativi e ambienti diversi

Il problema che Multi-Saxon risolve

Chi lavora con la TEI nell’umanistica digitale si scontra spesso con due ostacoli:

LXML (una comune libreria Python per l’elaborazione XML) sostiene soltanto XSLT 1.0, e preclude quindi le funzionalità più avanzate di XSLT 2.0/3.0
Elaborare in sequenza grandi corpora di documenti TEI può richiedere tempi proibitivi

Multi-Saxon risponde a entrambi sfruttando le capacità XSLT avanzate di Saxon e distribuendo l’elaborazione su più core, con guadagni di prestazioni notevoli.

Realizzazione

Multi-Saxon accoppia Python al processore Saxon per Java in una pipeline di trasformazione ad alte prestazioni:

usa la libreria Saxon per Java per un’elaborazione XSLT 2.0/3.0 robusta
ricorre al multiprocessing per distribuire le trasformazioni sui core disponibili
gestisce con efficienza i pool di processi per massimizzare il throughput
offre un’interfaccia semplice per l’elaborazione in batch dei documenti TEI

Esempio d’uso

from multi_saxon import MultiSaxon

# Initialize with your XSLT stylesheet
transformer = MultiSaxon("transform.xsl")

# Transform a single document
transformer.transform("input.xml", "output.xml")

# Transform an entire directory in parallel
transformer.transform_directory("input_dir", "output_dir")

Che cosa cambia per l’umanistica digitale

Per i progetti di umanistica digitale alle prese con grandi collezioni di documenti TEI, Multi-Saxon rende possibili:

trasformazioni complesse sull’intero corpus, impensabili con LXML
tempi di elaborazione drasticamente ridotti (spesso di 5-10 volte sui sistemi multi-core)
analisi più sofisticate grazie alle funzionalità avanzate di XSLT 2.0/3.0
un flusso di lavoro più semplice per elaborare intere collezioni di documenti

Il codice sorgente e la documentazione sono nel .

persNamer

Fri, 28 Mar 2025 00:00:00 +0000

persNamer: collegare la TEI al Virtual International Authority File

persNamer è uno strumento Python specializzato che facilita l’integrazione, nei documenti XML TEI, dei dati di autorità sulle persone forniti da VIAF (Virtual International Authority File). Convertendo gli identificatori VIAF in marcatura TEI pronta all’uso, riduce di molto il lavoro manuale necessario per creare voci di persona strutturate in un’edizione critica digitale.

Il controllo di autorità nella TEI

Le edizioni critiche digitali richiedono spesso di identificare con precisione i personaggi storici, con i nomi normalizzati e le date di nascita e di morte. Mantenere un controllo di autorità coerente in tutto un progetto richiede di:

identificare le persone nei testi storici
trovare dati autorevoli su di loro
creare voci TEI formattate a dovere
garantire riferimenti coerenti in tutto il progetto

Passaggi che, di norma, sono manuali, lenti e soggetti a incoerenze.

Come funziona persNamer

persNamer automatizza questo flusso di lavoro:

Recupero dei dati VIAF: dato un identificatore VIAF, lo strumento recupera i dati RDF tramite negoziazione del contenuto HTTP
Estrazione delle informazioni essenziali: analizza l’RDF per estrarre il nome preferito, la data di nascita e la data di morte
Generazione della marcatura TEI: crea due frammenti XML:
- una voce dell’authority file (elemento <person> con un xml:id generato, <persName>, <birth>, <death> e <idno type="VIAF">)
- un tag di annotazione a parte (<persName> con un attributo ref che rimanda alla voce di autorità)

Questo doppio output permette ai curatori di mantenere un authority file centralizzato e, insieme, di inserire con facilità i tag di annotazione nei loro testi TEI.

Caratteristiche principali

Generazione normalizzata degli ID: crea ID XML coerenti nella forma pers-[cognome]-[iniziale del nome] (per es. pers-deteligny-c)
Analisi RDF: usa rdflib per estrarre le informazioni da diverse proprietà RDF (per es. rdfs:label, schema:name, viaf:mainHead)
Interfaccia a riga di comando: si esegue con un numero VIAF come unico argomento obbligatorio
Output dettagliato: accompagna l’XML finale con informazioni dettagliate sull’elaborazione

Esempio d’uso

python persNamer.py 314802260

Questo comando produce:

<person xml:id="pers-deteligny-c">
 <persName>Charles deTéligny</persName>
 <birth>1535</birth>
 <death>1572-08-24</death>
 <idno type="VIAF">314802260</idno>
</person>

<persName ref="#pers-deteligny-c">Charles deTéligny</persName>

Applicazioni nell’umanistica digitale

persNamer torna particolarmente utile per:

le edizioni critiche digitali che richiedono un controllo di autorità
i progetti di codifica TEI che trattano personaggi storici
le iniziative di linked data che collegano documenti a record di autorità
garantire la coerenza in grandi corpora TEI
insegnare il controllo di autorità nei corsi di umanistica digitale

Realizzazione

persNamer è scritto in Python e dipende da:

requests per le richieste HTTP
rdflib per l’analisi RDF
lxml per la gestione dell’XML

Il codice sorgente e la documentazione sono nel .