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, žá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 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.