Python |

tei-mcp

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

tei-mcp: la TEI P5 per als agents d’IA

tei-mcp és un servidor de codi obert que dona als assistents de programació amb IA accés directe a l’especificació . En lloc de refiar-se del que recorda de l’entrenament – cosa que sovint produeix un marcatge plausible però incorrecte –, la IA pot consultar l’especificació en temps real.

Funcions

El servidor analitza l’ODD de la TEI P5 i exposa 16 eines:

Consultar qualsevol element, classe, macro o mòdul pel nom, sense distingir majúscules i amb suggeriments en cas d’errata
Resoldre atributs al llarg de tota la jerarquia de classes de la TEI (locals i heretats)
Expandir models de contingut en arbres estructurats, amb resolució de classes i macros
Validar la imbricació – relació directa pare-fill o accessibilitat recursiva, amb seguiment del camí
Validar documents segons la TEI P5: models de contingut, atributs, llistes de valors tancades, integritat de les referències i avisos d’obsolescència
Validar elements individuals per a fluxos d’edició incremental
Carregar personalitzacions ODD per restringir l’esquema al subconjunt propi d’un projecte
Cercar en tots els tipus d’entitat amb expressions regulars

Instal·lació

pip install tei-mcp

O bé executar-lo directament amb:

uvx tei-mcp

Ús

Afegeix-lo a qualsevol client compatible amb MCP (Claude, Cursor, Windsurf, etc.):

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

El codi font i la documentació són al .

Multi-Saxon

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

Multi-Saxon: processament XSLT en paral·lel per a grans corpus TEI

Multi-Saxon cobreix un buit important en les eines de processament XML: permet executar en paral·lel transformacions XSLT 2.0 i 3.0 que LXML (una biblioteca XML molt popular en Python) no pot gestionar. Dissenyat expressament per a grans col·leccions de documents XML TEI, Multi-Saxon accelera notablement el processament gràcies a una execució paral·lela eficient.

Característiques principals

Suport XSLT avançat: processa transformacions XSLT 2.0 i 3.0 fora de l’abast de LXML
Processament en paral·lel: redueix dràsticament el temps de transformació de grans col·leccions de documents gràcies a la paral·lelització
Optimitzat per a TEI: dissenyat específicament per a documents XML de la Text Encoding Initiative (TEI)
Rendiment escalable: gestiona amb eficiència corpus de centenars a milers de documents
Multiplataforma: funciona en sistemes operatius i entorns diversos

El problema que resol Multi-Saxon

Els investigadors en humanitats digitals que treballen amb TEI topen sovint amb dos obstacles importants:

LXML (una biblioteca habitual de processament XML en Python) només admet XSLT 1.0, cosa que impedeix fer servir les funcions més avançades d’XSLT 2.0/3.0
Processar seqüencialment grans corpus de documents TEI pot ser prohibitivament lent

Multi-Saxon resol tots dos problemes aprofitant les capacitats XSLT avançades de Saxon i repartint el processament entre diversos nuclis, amb guanys de rendiment considerables.

Implementació

Multi-Saxon combina Python amb el processador Saxon de Java per crear un flux de transformació d’alt rendiment:

Fa servir la biblioteca Saxon de Java per a un processament robust d’XSLT 2.0/3.0
Implementa el multiprocessament per distribuir les transformacions entre els nuclis de CPU disponibles
Gestiona eficientment els grups de processos per maximitzar el rendiment
Ofereix una interfície senzilla per processar documents TEI per lots

Exemple d’ús

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")

Impacte per a les humanitats digitals

Per als projectes d’humanitats digitals que treballen amb grans col·leccions de documents TEI, Multi-Saxon fa possible:

Transformacions complexes a escala de tot el corpus que serien impossibles amb LXML
Temps de processament dràsticament reduïts (sovint entre 5 i 10 vegades més ràpid en sistemes multinucli)
Anàlisis més sofisticades gràcies a les funcions avançades d’XSLT 2.0/3.0
Un flux de treball més senzill per processar col·leccions senceres de documents

El codi font i la documentació són al .

persNamer

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

persNamer: connectar la TEI amb el Virtual International Authority File

persNamer és una eina especialitzada en Python que facilita la integració en documents TEI XML de dades d’autoritat sobre persones procedents del VIAF (Virtual International Authority File). En convertir els identificadors VIAF en marcatge TEI a punt per fer servir, persNamer redueix notablement la feina manual que comporta crear entrades de persona estructurades per a les edicions acadèmiques digitals.

El repte del control d’autoritats en TEI

Les edicions acadèmiques digitals sovint exigeixen identificar amb precisió els personatges històrics, incloent-hi els seus noms normalitzats i les dates de naixement i mort. Mantenir un control d’autoritats coherent en tot un projecte requereix:

Identificar les persones en els textos històrics
Trobar-ne dades d’autoritat
Crear entrades TEI correctament formatades
Garantir referències coherents al llarg de tot el projecte

Aquests passos solen ser manuals, lents i propensos a la incoherència.

Com funciona persNamer

persNamer automatitza aquest flux de treball:

Obté les dades del VIAF: a partir d’un identificador VIAF, l’eina recupera les dades RDF mitjançant negociació de contingut HTTP
N’extreu la informació clau: analitza l’RDF per extreure’n el nom preferit, la data de naixement i la data de mort
Genera el marcatge TEI: crea dos fragments XML essencials:
- Una entrada de fitxer d’autoritats (element <person> amb un xml:id generat, <persName>, <birth>, <death> i <idno type="VIAF">)
- Una etiqueta d’anotació a part (<persName> amb un atribut ref que apunta a l’entrada d’autoritat)

Aquesta doble sortida permet als editors mantenir un fitxer d’autoritats centralitzat i, alhora, inserir fàcilment etiquetes d’anotació en els seus textos TEI.

Característiques principals

Generació d’identificadors normalitzats: crea identificadors XML coherents amb el format pers-[familyname]-[givenname initial] (p. ex., pers-deteligny-c)
Anàlisi d’RDF: fa servir rdflib per extreure informació de diverses propietats RDF (p. ex., rdfs:label, schema:name, viaf:mainHead)
Interfície de línia d’ordres: s’executa amb un número VIAF com a únic argument obligatori
Sortida detallada: proporciona informació detallada del processament juntament amb l’XML final

Exemple d’ús

python persNamer.py 314802260

Aquesta ordre produeix:

<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>

Aplicacions en humanitats digitals

persNamer és especialment útil per a:

Edicions acadèmiques digitals que requereixen control d’autoritats
Projectes de codificació TEI que treballen amb personatges històrics
Iniciatives de dades enllaçades que connecten documents amb registres d’autoritat
Garantir la coherència en grans corpus TEI
Ensenyar els conceptes del control d’autoritats en cursos d’humanitats digitals

Implementació

persNamer està escrit en Python i depèn de:

requests per a les peticions HTTP
rdflib per a l’anàlisi d’RDF
lxml per a la gestió de l’XML

El codi font i la documentació són al .