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.