textual-criticism-mcp

Biblical text analysis with textual criticism support. An MCP server for morphological analysis, manuscript variants, and concordance searches across Hebrew and Greek biblical texts.

Features

• Text-Fabric Integration: Full morphological and syntactic analysis of Hebrew (BHSA) and Greek (N1904) texts
• Textual Criticism: Variant readings, manuscript data, apparatus analysis
• Concordance: Search by lemma, morphology, or syntax patterns
• Lexicons: BDB (Hebrew), Thayer's (Greek), Strong's numbers
• Multiple Translations: Public domain texts (KJV, WEB, ASV, YLT, Darby, BBE)

Installation

# Basic installation
pip install textual-criticism-mcp

# With MCP server support
pip install textual-criticism-mcp[mcp]

# With CLI
pip install textual-criticism-mcp[cli]

# Everything
pip install textual-criticism-mcp[all]

Quick Start

Python Library

from textual_criticism_mcp.lib import parse_verse, search

# Parse a verse with full morphology
verse = parse_verse("John 3:16")
for word in verse.words:
    print(f"{word.text} ({word.lemma}) - {word.pos}")

# Search for a lemma
results = search("word lex=ἀγάπη", corpus="greek")

MCP Server

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "textual-criticism": {
      "command": "python",
      "args": ["-m", "textual_criticism_mcp.mcp.server"]
    }
  }
}

Or with uvx:

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

MCP Tools

parse_verse

Parse a verse with complete morphological analysis.

parse_verse("Gen 1:1", detail_level="syntax")

Returns word-by-word breakdown with:

• Original text + transliteration
• Lemma and Strong's number
• Full morphological parsing (POS, person, gender, number, tense, voice, mood, case, state, stem)
• Syntactic information (phrase function, clause type)

search_lemma

Find all occurrences of a word.

search_lemma("ἀγάπη", corpus="nt", limit=100)

search_morphology

Search by grammatical criteria.

search_morphology(language="hebrew", pos="verb", stem="qal", mood="imperative")

get_variants

Get textual variants for a passage.

get_variants("Mark 16:9-20", include_manuscripts=True)

Returns:

• All variant readings
• Manuscript support (P46, א, B, etc.)
• Edition support (NA28, SBLGNT, TR)
• Variant classification and transcriptional analysis

get_passage

Retrieve passage text in multiple translations.

get_passage("Rom 8:1-4", translations=["KJV", "WEB", "ASV"], include_original=True)

Data Sources

• Hebrew Bible: BHSA (Biblia Hebraica Stuttgartensia Amstelodamensis) via Text-Fabric
• Greek NT: Nestle 1904 via Text-Fabric
• Apparatus: STEPBible TAGNT/TAHOT (CC BY 4.0)
• Lexicons: OpenScriptures BDB, Strong's, Thayer's
• Translations: wldeh/bible-api (public domain texts)

First Run

Text-Fabric corpora are downloaded automatically on first use (~300MB total).

from textual_criticism_mcp.lib.corpus import get_corpus_manager

# This will download BHSA and N1904 on first run
cm = get_corpus_manager()
cm.hebrew  # Downloads Hebrew corpus
cm.greek   # Downloads Greek corpus

Development

# Clone and install in dev mode
git clone https://github.com/yourusername/textual-criticism-mcp
cd textual-criticism-mcp
pip install -e ".[all]"

# Run tests
pytest

# Type check
mypy src/textual_criticism_mcp

# Lint
ruff check src/textual_criticism_mcp

License

MIT

Acknowledgments

• Text-Fabric - Corpus infrastructure
• ETCBC - BHSA Hebrew Bible data
• STEPBible - Apparatus and tagged texts
• OpenScriptures - Lexicons and morphology