# kjv-bible-mcp-server

MCP server, který dá Claude.ai přístup k textu Bible — výchozí překlad je
**KJV (King James Version)**. Text je zdarma poskytován službou
[bible-api.com](https://bible-api.com), žádný API klíč není potřeba.

Nemusíš umět programovat. Stačí projít návod níže z mobilu — vše se dělá
klikáním v prohlížeči.

## Co server umí

Claude bude po připojení umět:

- **najít verš nebo pasáž** podle reference, např. "John 3:16" nebo
  "John 3:16-18",
- **zobrazit celou kapitolu** podle knihy a čísla kapitoly, např. Žalm 23,
- **vypsat seznam knih** daného překladu,
- **vypsat seznam dostupných překladů**.

## Limity (vědomě přijaté, není co řešit)

- **Jen angličtina a další public domain překlady** (KJV, WEB, ASV a
  podobné). Čeština k dispozici není.
- **Žádné fulltextové hledání** — server umí jen najít konkrétní referenci
  (např. "John 3:16") nebo procházet kapitoly, ne hledat frázi v celé
  Bibli.
- **Rate limit**: bible-api.com dovolí 15 dotazů za 30 sekund z jedné IP
  adresy. Pro běžné použití v chatu to bohatě stačí; při překročení server
  vrátí srozumitelnou zprávu, ať to zkusíš za chvíli znovu.
- **Free tier na Renderu usíná** po ~15 minutách nečinnosti. První dotaz po
  probuzení tak může trvat 30–60 sekund, další dotazy jsou pak rychlé. Pro
  občasné použití je to v pohodě.

## Nasazení na Render (klikací návod)

1. Otevři [dashboard.render.com](https://dashboard.render.com) a přihlas se
   přes GitHub.
2. Klikni na **New** → **Blueprint**.
3. Vyber repozitář `kjv-bible-mcp-server`.
4. Klikni na **Apply**.
5. Počkej pár minut, než se build a deploy dokončí.
6. Zkopíruj URL adresu služby (najdeš ji nahoře na stránce služby, něco
   jako `https://kjv-bible-mcp-server-xxxx.onrender.com`).
7. V prohlížeči ověř, že `https://TVOJE-URL/health` vrátí `{"status":"ok"}`.

## Připojení do Claude.ai

1. V Claude.ai jdi do **Settings** → **Connectors** → **Add custom
   connector** (pokud to v mobilní appce nenajdeš, otevři claude.ai
   v prohlížeči mobilu).
2. Jako URL vlož `https://TVOJE-URL/mcp` (na konci `/mcp`, ne jen doménu).
3. Ulož a v novém chatu zkus napsat: *"Dej mi John 3:16 v KJV."* Claude by
   měl použít tool `bible_get_passage` a vrátit ti text verše.

## Technické detaily (pro pořádek)

- TypeScript, oficiální `@modelcontextprotocol/sdk`.
- Transport: HTTP (`POST /mcp`, stateless) — řízeno proměnnou prostředí
  `TRANSPORT` (`http` nebo `stdio`), na Renderu nastaveno na `http`.
- Port se čte z `process.env.PORT` (Render si ho řídí sám).
- `/mcp` nevyžaduje žádnou autentizaci — server jen čte veřejně dostupný
  (public domain) text Bible, nic citlivého.