tei-mcp

tei-mcp: la TEI P5 per gli agenti IA

tei-mcp è un server MCP open source che dà agli assistenti IA per la programmazione un accesso diretto alla specifica TEI P5. 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 repository GitHub.