Python |

tei-mcp

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

tei-mcp: TEI P5 für KI-Agenten

tei-mcp ist ein quelloffener -Server, der KI-Programmierassistenten unmittelbaren Zugriff auf die -Spezifikation verschafft. Statt sich auf angelerntes Trainingswissen zu verlassen – das oft plausibel aussehendes, aber falsches Markup hervorbringt –, kann die KI die Spezifikation in Echtzeit befragen.

Funktionen

Der Server liest das ODD von TEI P5 ein und stellt 16 Tools bereit:

Nachschlagen von Elementen, Klassen, Makros und Modulen nach Namen, ohne Rücksicht auf Groß- und Kleinschreibung und mit Vorschlägen bei Tippfehlern
Attribute auflösen über die gesamte TEI-Klassenhierarchie (lokal + geerbt)
Inhaltsmodelle entfalten zu strukturierten Bäumen, mit Auflösung von Klassen und Makros
Verschachtelung prüfen – direkte Eltern-Kind-Beziehung oder rekursive Erreichbarkeit mit Pfadverfolgung
Dokumente validieren gegen TEI P5: Inhaltsmodelle, Attribute, geschlossene Wertelisten, Integrität der Verweise und Warnungen vor veralteten Konstrukten
Einzelne Elemente validieren für schrittweises Bearbeiten
ODD-Anpassungen laden, um das Schema auf die projektspezifische Teilmenge einzuschränken
Suchen über alle Entitätstypen hinweg mit regulären Ausdrücken

Installation

pip install tei-mcp

Oder direkt starten mit:

uvx tei-mcp

Verwendung

In einen beliebigen MCP-kompatiblen Client eintragen (Claude, Cursor, Windsurf usw.):

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

Quellcode und Dokumentation finden Sie im .

Multi-Saxon

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

Multi-Saxon: Parallele XSLT-Verarbeitung für große TEI-Korpora

Multi-Saxon schließt eine empfindliche Lücke im Werkzeugkasten der XML-Verarbeitung: Es führt XSLT-2.0- und -3.0-Transformationen parallel aus, an denen LXML (die verbreitete Python-Bibliothek für XML) scheitert. Eigens für große Sammlungen von XML-TEI-Dokumenten gebaut, verkürzt Multi-Saxon die Verarbeitungszeit durch effiziente Parallelisierung beträchtlich.

Hauptmerkmale

Erweiterte XSLT-Unterstützung: Verarbeitet XSLT-2.0- und -3.0-Transformationen, die LXML nicht beherrscht
Parallele Verarbeitung: Verkürzt die Transformationszeit großer Dokumentsammlungen durch Parallelisierung drastisch
TEI-optimiert: Eigens für XML-Dokumente der Text Encoding Initiative (TEI) ausgelegt
Skalierbare Leistung: Verarbeitet Korpora von Hunderten bis Tausenden von Dokumenten effizient
Plattformübergreifend: Läuft unter verschiedenen Betriebssystemen und in verschiedenen Umgebungen

Das Problem, das Multi-Saxon löst

Wer in den Digital Humanities mit TEI arbeitet, stößt regelmäßig auf zwei Hindernisse:

LXML (die gängige Python-Bibliothek zur XML-Verarbeitung) unterstützt nur XSLT 1.0; die weiterentwickelten Möglichkeiten von XSLT 2.0/3.0 bleiben damit außer Reichweite
Große TEI-Korpora Dokument für Dokument zu verarbeiten kann unzumutbar lange dauern

Multi-Saxon räumt beide Hindernisse aus dem Weg: Es nutzt die fortgeschrittenen XSLT-Fähigkeiten von Saxon und verteilt die Arbeit auf mehrere Prozessorkerne, was erhebliche Geschwindigkeitsgewinne bringt.

Implementierung

Multi-Saxon verbindet Python mit dem Java-Prozessor Saxon zu einer leistungsfähigen Transformations-Pipeline:

Nutzt die Java-Bibliothek Saxon für robuste XSLT-2.0/3.0-Verarbeitung
Verteilt die Transformationen per Multiprocessing auf die verfügbaren CPU-Kerne
Verwaltet die Prozessor-Pools so, dass der Durchsatz maximal wird
Bietet eine schlichte Schnittstelle für die Stapelverarbeitung von TEI-Dokumenten

Anwendungsbeispiel

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

Was das für die Digital Humanities bedeutet

Projekten der Digital Humanities mit großen TEI-Dokumentsammlungen eröffnet Multi-Saxon:

Komplexe korpusweite Transformationen, die mit LXML unmöglich wären
Drastisch kürzere Verarbeitungszeiten (auf Mehrkernsystemen oft um den Faktor 5–10)
Anspruchsvollere Analysen dank der fortgeschrittenen Funktionen von XSLT 2.0/3.0
Einfachere Arbeitsabläufe bei der Verarbeitung ganzer Dokumentsammlungen

Quellcode und Dokumentation finden Sie im .

persNamer

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

persNamer: TEI mit dem Virtual International Authority File verknüpfen

persNamer ist ein spezialisiertes Python-Werkzeug, das Personen-Normdaten aus VIAF (Virtual International Authority File) ohne Umwege in TEI-XML-Dokumente holt. Weil es VIAF-Identifikatoren in fertiges TEI-Markup übersetzt, erspart persNamer einen Großteil der Handarbeit, die strukturierte Personeneinträge in digitalen wissenschaftlichen Editionen sonst verlangen.

Die Mühen der Normdatenpflege in TEI

Digitale wissenschaftliche Editionen müssen historische Personen häufig exakt identifizieren, samt normiertem Namen und Lebensdaten. Wer die Normdaten über ein ganzes Projekt hinweg konsistent halten will, muss:

Personen in historischen Texten erkennen
verlässliche Normdaten zu ihnen finden
korrekt formatierte TEI-Einträge anlegen
dafür sorgen, dass die Verweise im ganzen Projekt einheitlich bleiben

All das geschieht in der Regel von Hand, kostet Zeit und lädt zu Inkonsistenzen ein.

Wie persNamer arbeitet

persNamer automatisiert diesen Ablauf, indem es:

VIAF-Daten abruft: Zu einem gegebenen VIAF-Identifikator holt das Werkzeug per HTTP Content Negotiation die RDF-Daten
die Kerninformationen ausliest: Aus dem RDF zieht es den bevorzugten Namen sowie Geburts- und Sterbedatum
TEI-Markup erzeugt: Es liefert zwei unentbehrliche XML-Schnipsel:
- einen Eintrag für die Normdatei (<person>-Element mit generierter xml:id, <persName>, <birth>, <death> und <idno type="VIAF">)
- ein eigenes Annotations-Tag (<persName> mit einem ref-Attribut, das auf den Normdateneintrag verweist)

Diese zweifache Ausgabe erlaubt es Editorinnen und Editoren, eine zentrale Normdatei zu führen und die Annotations-Tags zugleich bequem in ihre TEI-Texte einzusetzen.

Hauptmerkmale

Einheitliche ID-Vergabe: Erzeugt konsistente XML-IDs nach dem Muster pers-[familyname]-[givenname initial] (z. B. pers-deteligny-c)
RDF-Parsing: Liest mit rdflib Informationen aus verschiedenen RDF-Eigenschaften aus (z. B. rdfs:label, schema:name, viaf:mainHead)
Kommandozeile: Ein Aufruf mit der VIAF-Nummer als einzigem Pflichtargument genügt
Ausführliche Ausgabe: Liefert neben dem fertigen XML detaillierte Angaben zur Verarbeitung

Anwendungsbeispiel

python persNamer.py 314802260

Dieser Befehl erzeugt:

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

Einsatz in den Digital Humanities

persNamer ist besonders nützlich für:

digitale wissenschaftliche Editionen, die Normdatenpflege verlangen
TEI-Kodierungsprojekte, in denen historische Persönlichkeiten vorkommen
Linked-Data-Vorhaben, die Dokumente mit Normdatensätzen verknüpfen
die Wahrung der Konsistenz in großen TEI-Korpora
die Vermittlung der Normdatenpflege in Lehrveranstaltungen der Digital Humanities

Implementierung

persNamer ist in Python geschrieben und stützt sich auf:

requests für HTTP-Anfragen
rdflib für das RDF-Parsing
lxml für die XML-Verarbeitung

Quellcode und Dokumentation finden Sie im .