# தமிழ் வேதாகம ஆய்வு MCP சேவையகம் (studybible-tamil-mcp)

[djayatillake/studybible-mcp](https://github.com/djayatillake/studybible-mcp) என்ற ஆங்கில வேதாகம ஆய்வு MCP சேவையகத்தின் **முழுமையான தமிழ் சமமானது**. ஆங்கில சேவையகத்தின் ஒவ்வொரு அம்சத்திற்கும் தமிழ் இணை உண்டு; மேலும் தமிழுக்கு மட்டுமான சிறப்பு அம்சங்களும் உண்டு.

## முக்கிய அம்சங்கள்

### வேத உரை — இரு மொழிபெயர்ப்புகள்
- **தமிழ் பாரம்பரிய உரை (BSI)** — முழு வேதாகமம், 66 நூல்கள், சங்கீதப் படல அடிக்குறிப்புகள் உட்பட
- **தமிழ் IRV** — சொல்-சீரமைப்பு (word alignment) தரவுடன்; ஒவ்வொரு தமிழ் சொல்லும் மூல எபிரேய/கிரேக்க Strong's எண்ணோடு இணைக்கப்பட்டது
- எல்லா கருவிகளிலும் பாரம்பரிய உரை முதலில், IRV அடுத்து, மூல மொழி உரை மூன்றாவது

### 22 கருவிகள் (ஆங்கிலத்தின் 19 + தமிழ் சிறப்பு)

| கருவி | செயல் |
|---|---|
| `word_study` | ஒரு மூல மொழிச் சொல்லின் முழு ஆய்வு — தமிழ் சொற்பொருள், தமிழ் வழங்கல்கள், tw கட்டுரைகள் |
| `lookup_verse` | வசனம் — தமிழ் பாரம்பரிய + IRV + மூலம், தமிழ் குறிப்புகள் (யோவான் 3:16 போன்ற தமிழ் குறிப்புகளும் ஏற்கும்) |
| `search_lexicon` | கிரேக்க/எபிரேய லெக்சிகன் — தமிழ் சொற்பொருள்களோடு (7,000+ நுழைவுகள்; புதிய ஏற்பாட்டில் வரும் ஒவ்வொரு கிரேக்கச் சொல்லுக்கும் தமிழ் சொற்பொருள் உண்டு) |
| `search_by_strongs` | Strong's எண்ணால் தேடல் — தமிழ் வழங்கல்கள், இடங்கள், tw/ta இணைப்புகள் |
| `get_cross_references` | குறுக்கு-குறிப்புகள் — ஒவ்வொரு வசனத்தின் தமிழ் உரையும் உடனே |
| `lookup_name` | பெயர் அகராதி — 476 தமிழ் பெயர் வகைகள் (திருவெளிப்பாடு, முதல் சாமுவேல் போன்றவையும்) |
| `parse_morphology` | இலக்கணப் பகுப்பாய்வு — **தமிழ் இலக்கண விளக்கம்** |
| `get_study_notes` | ஆய்வுக் குறிப்புகள் — தமிழ் நூல் அறிமுகம் + tn குறிப்புகள் + tq கேள்விகள் |
| `get_bible_dictionary` | வேதாகம அகராதி — தமிழ் முதன்மை |
| `get_key_terms` | முக்கியச் சொற்கள் — தமிழ் முதன்மை |
| `get_ane_context` | பண்டை அண்ணாத்திர சூழல் — **முழுவதும் தமிழில் மொழிபெயர்க்கப்பட்ட 120 கட்டுரைகள்** |
| `get_theology_context` | இறையியல் அறிவு — **முழுவதும் தமிழில் மொழிபெயர்க்கப்பட்ட 193 கட்டுரைகள்** (Stott, Heiser, Owen, Lennox) |
| `get_torah_weave` | தோரா நெசவு அமைப்பு |
| `get_textual_variant` | உரை மாறுபாடுகள், கையெழுத்துப் பிரதி சாட்சிகள் |
| `find_similar_passages` | ஒத்த பகுதிகள் (திசையன் தேடல்) |
| `explore_genealogy` / `explore_person_events` / `explore_place` / `find_connection` / `people_in_passage` / `graph_enriched_search` | Theographic வரைபடம் — தமிழ் பெயர்களாலும் தேடலாம் (ரூத்து → இயேசு போன்ற நீண்ட தொடர்புகளும் வேலை செய்யும்) |
| **`search_tamil_verses`** | **தமிழ் சிறப்பு:** முழு வேதாகமத்தில் தமிழ் முழு-உரைத் தேடல் (FTS5) — "கடவுள் அன்பு" போன்ற சொற்றொடர்கள் |

### தரவு மூலங்கள் — விசுவாசத்திற்கு முன்னுரிமை
1. **வேத உரை**: தொழில்முறை மொழிபெயர்ப்புகள் மட்டுமே — தமிழ் IRV (Door43) + தமிழ் BSI பாரம்பரிய உரை. LLM-ஆல் உருவாக்கப்பட்ட வேத உரை எதுவும் இல்லை.
2. **விளக்க உள்ளடக்கம்**: Door43 தமிழ் வளங்கள் (ta_tw அகராதி 1,017, ta_tn குறிப்புகள் 12,081, ta_tq கேள்விகள் 2,077) — முதலில்.
3. **மொழிபெயர்ப்பு**: தமிழ் இணை இல்லாத ஆங்கில உள்ளடக்கம் (ANE 120, இறையியல் 193, லெக்சிகன் சொற்பொருள்கள் 1,090+ கையால் சரிபார்க்கப்பட்டவை, மொழிபெயர்க்கப்பட்டது) — எளிய தமிழில், வேதாகமத்திற்கு விசுவாசமாக; சரிபார்ப்புக்கு ஆங்கில மூலம் உரையோடு சேமிக்கப்பட்டது.

## நிறுவல்

**1. தரவுத்தளத்தை இறக்கவும்** (~280 MB சுருக்கப்பட்டது) — [Releases](../../releases) பக்கத்திலிருந்து `studybible-tamil-data-v1.0.0.tar.gz` ஐ பதிவிறக்கி, `data/` கோப்புறையில் விரிக்கவும்:

```bash
mkdir -p data && tar xzf studybible-tamil-data-v1.0.0.tar.gz -C data
```

**2. தொகுப்பை நிறுவவும்:**

```bash
py -3.11 -m pip install -e .
```

(முழு தரவுத்தளம் ~740 MB; GitHub கோப்பு வரம்பு காரணமாக Release வழியாகவே வழங்கப்படுகிறது. தரவு `data/` கோப்புறையில் இருந்தால் போதும், சொந்த இடத்தில் இருந்தால் `STUDY_BIBLE_TAMIL_DB` சூழல் மாறியால் சுட்டலாம்.)

தரவுத்தளம் `data/study_bible_tamil.db` (~700 MB) தானாகக் கண்டறியப்படும். வேறு இடத்தில் இருந்தால்:

```bash
set STUDY_BIBLE_TAMIL_DB=C:\path\to\study_bible_tamil.db
```

## Claude Desktop / ZCode அமைப்பு

```json
{
  "mcpServers": {
    "studybible-tamil": {
      "command": "py",
      "args": ["-3.11", "-m", "study_bible_tamil_mcp.server"],
      "env": {
        "STUDY_BIBLE_TAMIL_DB": "C:\\path\\to\\studybible-tamil\\data\\study_bible_tamil.db"
      }
    }
  }
}
```

## ஆய்வு API (Android செயலிக்காக)

`server/study_api.py` — செயலியின் ஆய்வுத் தரவுகளுக்கான HTTP API (verse study, word study, search, offline pack):

```bash
py -3.11 server/study_api.py          # port 8787, key: server/study_key.txt
py -3.11 server/build_study_pack.py   # offline pack (tamil_study_pack.zip) உருவாக்க
```

அணுகல்: `X-Study-Key` header அல்லது `?key=` — key இல்லாத கோரிக்கைகள் 401. ஒரு IP-க்கு வரம்பு: 120 req/min, pack 6/hour. `/api/health` திறந்தது. Cloudflare tunnel உதாரணம்: `~/.cloudflared/config-tamilbible.yml`.

## சோதனை

```bash
py -3.11 scripts/test_server.py
```

33 சோதனைகள் — வசன மீட்பு, தமிழ் குறிப்புகள், இரு-உரை, FTS தேடல், லெக்சிகன், இறையியல்/ANE தமிழ், வரைபடம் எல்லாம் உள்ளடங்கும்.

## உரிமம்

MIT — மூல [studybible-mcp](https://github.com/djayatillake/studybible-mcp) போலவே.