Humanitats Digitals |

tei-mcp v0.3: codificar en TEI sense reescriure la font

Tue, 05 May 2026 00:00:00 +0000

Quan , l’objectiu era evitar que els assistents d’IA al·lucinessin marcatge TEI. L’ancoratge a l’esquema en va resoldre una part: amb accés directe, mitjançant eines, a l’especificació P5, el model ja no ha d’endevinar què significa un element ni quins atributs accepta. El resultat valida.

Però en la codificació TEI l’al·lucinació té dues cares, i l’esquema només n’atrapa una. Validar contra l’especificació et diu que el marcatge està ben format. No diu res del text que aquest marcatge embolcalla. I és allà – en el text mateix – on viuen les al·lucinacions més perjudicials. La composició per intervals blocats (span-locked composition), la novetat estrella de la v0.3, està dissenyada precisament per evitar-les.

Index

L’al·lucinació que l’esquema no pot atrapar

Demana a un model que codifiqui una carta francesa del segle XVI i sovint et tornarà un document TEI d’aspecte impecable. La capçalera és plena, les etiquetes <persName> són al lloc correcte, el <dateline> està ben format. Passa’l per validate_document i el supera.

Després compara el cos amb la font.

mesme s’ha convertit en même. Una coma ha emigrat. luy s’ha modernitzat silenciosament en lui. Una frase difícil de llegir al manuscrit ha estat «corregida» cap a alguna cosa més neta. Cap d’aquests canvis no s’havia demanat. Cap no està assenyalat. El document és vàlid segons l’esquema i discretament erroni.

En un flux de treball arxivístic – on el text codificat esdevé el registre permanent de què depenen els lectors, els índexs de cerca i les citacions – aquest és el mode de fallada que més importa. Una etiqueta mal formada és una molèstia. Una grafia modernitzada que ningú no detecta durant cinc anys és una corrupció.

La composició per intervals blocats

La nova versió (v0.3) incorpora un mecanisme de prevenció d’al·lucinacions que apunta directament a aquest mode de fallada. L’objectiu de disseny és fer que les al·lucinacions en el cos del text siguin impossibles per construcció, no merament improbables.

La idea és senzilla: el model no escriu mai el cos del text.

En lloc d’això, el flux de treball és el següent:

El model crida get_source("letter_001") i rep el text pla de la font com una cadena immutable.
Per a cada etiqueta que vol aplicar, crida tag_span("letter_001", start, end, element_path, attrs), i registra així un element TEI sobre un interval de caràcters de la font.
Quan ha acabat, crida compose("letter_001"). El servidor intercala les etiquetes registrades amb el text pla original, genera la TEI final i, tot seguit, verifica byte a byte que el contingut textual pla del document generat és igual a la font.

Si els bytes coincideixen, el document es retorna. Si no – si les etiquetes del model impliquen d’alguna manera un cos que difereix de la font encara que sigui en un sol caràcter –, compose() llança un error en lloc de retornar un document corromput.

No hi ha cap camí en aquest flux de treball pel qual el model produeixi un document TEI amb un cos de text diferent de la font. L’invariant és mecànic, no conductual. No cal confiar que el model no al·lucini; cal confiar en una comprovació == entre dues cadenes de bytes.

Què és, i què no és

La composició per intervals blocats és complementària de l’ancoratge a l’esquema, no el substitueix. Les eines d’ancoratge a l’esquema (validate_document, lookup_element, valid_children i la resta de les setze originals) ajuden el model a produir una TEI vàlida. La composició per intervals blocats garanteix que el cos del text dins d’aquesta TEI és fidel a la font. Un flux de codificació apte per al desplegament ha de satisfer tots dos eixos, i ara un sol servidor els cobreix tots dos.

Tampoc no és una vareta màgica que ho arregli tot. compose() encara no comprova que les etiquetes registrades siguin admissibles segons una personalització ODD carregada: això vindrà més endavant. Les etiquetes registrades viuen a la memòria del procés i no sobreviuen a un reinici. I els fitxers font han de ser llegibles des d’allà on s’executa el servidor. Tot això té solució; res d’això no soscava l’invariant central.

Per què importa més enllà de la TEI

El patró es generalitza. Sempre que es demana a un model que anoti, transformi o embolcalli un fragment de text – i sempre que la integritat del text subjacent importa més que la capacitat del model per «millorar-lo» – s’hi aplica la mateixa forma de solució. No demanis al model que torni a teclejar el text. Demana-li que produeixi instruccions sobre el text, i deixa que un compositor determinista les apliqui sota un invariant d’igualtat.

Per a les edicions digitals en concret, això canvia el que es pot demanar responsablement a un model. La codificació esdevé de cop una tasca que es pot delegar sense haver de comparar manualment cada resultat amb la font. La màquina fa el camí avorrit; l’editor revisa el marcatge, no l’ortografia.

Obtenir l’actualització

Si ja tens tei-mcp instal·lat:

uvx tei-mcp@latest

O bé, des de zero:

pip install tei-mcp

Per fer servir la composició per intervals blocats, apunta el servidor a un directori de fitxers font en text pla:

export TEI_MCP_SPAN_SOURCE_ROOT=/path/to/sources
uvx tei-mcp

El nom de cada fitxer, sense l’extensió, esdevé l’identificador del document (letter_001.txt → letter_001).

Codi font, documentació completa i notes de disseny de l’invariant:

Una edició digital d’una altra mena

Tue, 24 Mar 2026 00:00:00 +0000

La majoria de fonts primàries no es publiquen mai. El model amb què confiem posar-hi remei, l’edició digital finançada amb subvencions, és massa car, massa centralitzat i massa fràgil per funcionar a gran escala. Acabo de publicar on explico per què construeixo l’edició crítica de les cartes de Cavriana d’una altra manera: fonts primàries digitalitzades que creixen orgànicament, amb una infraestructura mínima, un manteniment automatitzat, obertes a la col·laboració i tan barates que ni tan sols calen subvencions. És una defensa d’unes humanitats digitals que funcionen tant si hi ha suport institucional com si no.

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

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

Qui hagi fet servir un assistent de programació amb IA per escriure XML TEI probablement s’haurà adonat que s’equivoca. Apareixen elements on no toca. S’inventen atributs. Les regles d’imbricació s’ignoren. El model té una idea aproximada de quin aspecte té la TEI, però cap coneixement fiable de l’especificació.

tei-mcp ho resol donant als agents d’IA un accés directe, mitjançant eines, a les directrius de la TEI P5.

Index

Què és MCP?

El (MCP) és un estàndard obert que permet a les aplicacions d’IA connectar-se a fonts de dades i eines externes. Pensa-hi com en un port USB per a la IA: un únic protocol amb què qualsevol client compatible – Claude, Cursor, Windsurf i d’altres – pot endollar-se a serveis especialitzats.

Un servidor MCP exposa eines que la IA pot invocar durant una conversa. En lloc de refiar-se de les dades d’entrenament memoritzades, el model pot consultar una font viva i autoritzada.

Què fa tei-mcp

tei-mcp analitza l’especificació ODD de la TEI P5 i exposa 16 eines que cobreixen les preguntes més habituals que es faria un editor o un codificador:

Què és aquest element? Consulta qualsevol element, classe, macro o mòdul pel nom, sense distingir majúscules i amb suggeriments en cas d’errata.
Quins atributs admet? Resol els atributs al llarg de tota la jerarquia de classes: primer els locals, després els heretats, per ordre.
Què hi pot anar a dins? Expandeix els models de contingut en arbres estructurats, o obtén una llista plana de fills vàlids.
Aquest element pot anar aquí? Comprova la imbricació pare-fill, o traça l’accessibilitat a través de tota la jerarquia d’elements.
El meu document és vàlid? Valida un fitxer XML TEI segons l’especificació: models de contingut, valors d’atribut, llistes de valors tancades, integritat de les referències i avisos d’obsolescència.
I l’esquema del meu projecte? Carrega un fitxer de personalització ODD per restringir tot l’anterior al subconjunt específic de la TEI que fa servir el teu projecte.

Per què importa

Codificar en TEI exigeix consultar constantment les directrius. Els codificadors experimentats interioritzen els patrons més comuns, però fins i tot ells han de comprovar l’especificació quan es tracta d’elements menys familiars o de models de contingut complexos. Per als assistents d’IA, que no tenen cap coneixement interioritzat d’aquesta mena, el problema és pitjor: al·lucinen un marcatge d’aparença plausible però incorrecte.

Amb tei-mcp, la IA no ha d’endevinar res. Pot buscar la resposta a l’especificació abans d’escriure ni un sol parèntesi angular. El resultat és un marcatge conforme a la TEI P5, o a la personalització ODD del teu projecte.

Per començar

Instal·la’l des de PyPI:

pip install tei-mcp

Després, afegeix-lo a la configuració del teu client MCP:

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

El servidor descarrega l’especificació de la TEI la primera vegada que s’executa i funciona amb qualsevol client compatible amb MCP.

Codi font i documentació completa:

Ensenyar el sistema binari amb l’emulador de telègraf ITA2

Thu, 13 Feb 2025 00:00:00 +0000

Fer tangibles els conceptes abstractes

Aquest emulador de l’ITA2 és una eina docent pràctica. En fer visibles i interactius uns conceptes de codificació que d’entrada són abstractes, introdueix els estudiants a una noció clau de la informàtica i de les telecomunicacions: la representació binària, és a dir, com un text es converteix en seqüències d’uns i de zeros. Sovint ho ensenyem de manera abstracta; veure aparèixer els forats de debò ajuda els estudiants a entendre com un sistema físic pot representar informació digital.

ITA2 (Baudot-Murray) Telegraph Type Emulator

Type a word in the input below to see its representation on the ITA2 tape.

Type word:

Context històric: del telègraf a la informàtica

El codi ITA2 (Alfabet Telegràfic Internacional núm. 2), conegut també com a codi Baudot-Murray, es va desenvolupar als anys vint del segle XX com un refinament del codi telegràfic original que Émile Baudot havia ideat als anys setanta del segle XIX. Aquests primers sistemes de telecomunicació van influir directament en l’evolució posterior de la informàtica:

L’esquema de codificació de 5 bits va ser un dels primers exemples de codificació de caràcters
Les limitacions del joc de caràcters (només 32 combinacions possibles amb 5 bits) van donar lloc a l’enginyós mecanisme de canvi LLETRES/XIFRES
El sistema es va fer servir en els teletips fins ben entrat el segle XX

Aprendre les màquines d’estats jugant

El mecanisme de canvi LLETRES/XIFRES introdueix les màquines d’estats de manera natural. Tot experimentant, els estudiants descobreixen que un mateix patró pot representar caràcters diferents segons el mode actiu. Aquesta experiència directa amb la codificació basada en estats els prepara per a conceptes informàtics més complexos. Per exemple, el patró de bits 00011 representa:

La lletra «A» en mode LLETRES
El número «1» en mode XIFRES Aquesta doble interpretació segons l’estat és un principi fonamental de com els ordinadors treballen amb les dades.

Activitats per a l’aula

Algunes maneres d’incorporar l’emulador de l’ITA2 a la docència:

Repte de desxifratge: fer que els estudiants descodifiquin missatges codificats en patrons ITA2
Codificació eficient: discutir per què el mecanisme de canvi era important per estalviar amplada de banda
Evolució de la codificació: comparar el codi de 5 bits de l’ITA2 amb l’ASCII (7 bits) i amb Unicode
Informàtica física: relacionar aquest sistema històric amb microcontroladors moderns com Arduino

Avantatges per a l’accessibilitat

Més enllà de l’interès històric, aquest enfocament ajuda estudiants amb estils d’aprenentatge diferents:

Els aprenents visuals veuen els patrons
Els aprenents cinestèsics interactuen directament amb el procés de codificació
Els pensadors conceptuals poden explorar els aspectes matemàtics de la teoria de la informació

Detalls d’implementació

L’emulador està escrit en JavaScript i s’integra fàcilment en qualsevol plataforma d’aprenentatge en línia. El codi és modular i es pot adaptar a contextos docents diversos. Pots consultar el codi font i provar l’emulador tu mateix a: