Access Biblical Texts Reliably
MCP server for reliable, repeatable Bible verse lookup by reference, plus a Docker container exposing the same data via an OpenAI-compatible completions API.
Why it matters
Integrate reliable and reproducible biblical text lookup into your AI/LLM applications. This MCP server ensures consistent results for interpretation, research, and educational purposes.
Outcomes
What it gets done
Retrieve biblical verses by reference and language
Deploy as a Docker container for OpenAI compatibility
Integrate with Claude Desktop via MCP
Access API documentation via Swagger UI
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-ai-bible | bash Capabilities
Tools your agent gets
Retrieve biblical verses by reference and language
Overview
ai-Bible MCP Server
An MCP server, and companion Docker container, that looks up Bible verses by reference for AI research and educational use, built for reproducible, repeatable results rather than free-form generation. Use it when an LLM workflow needs consistent, sourced Bible verse text, in Claude Desktop via the MCP server, or through the Docker container's OpenAI-compatible completions API for other clients like Open WebUI.
What it does
ai-Bible gives an LLM a reliable, repeatable way to look up Bible text by reference, instead of relying on the model's own free-form recall, which can vary between runs. The project ships two ways to access this: an MCP server for direct integration with Claude Desktop, and a Docker container that wraps the same lookup logic with mcpo to expose it as an OpenAI-compatible completions API. Results are meant to be reproducible and reasonable enough to represent in different forms for research or educational purposes. A separate web front end, described as a pocket bible, is also available at ai-bible.com.
When to use - and when NOT to
Use the MCP server when Claude Desktop needs to pull specific Bible verses by reference as part of a research or educational workflow and the priority is consistency across repeated lookups rather than open-ended theological discussion. Use the Docker completions API instead when the consuming client is not Claude Desktop - for example, Open WebUI backed by a local model via Ollama. It is not a general biblical-commentary or interpretation engine: the source describes it as a lookup and retrieval layer for verse text, not a tool for generating exegesis or analysis.
Capabilities
The MCP server exposes verse lookup through the mcp-server.stdio.js build artifact, which Claude Desktop can be configured to run directly. The Docker container's completions API accepts a get-verse request with a reference array and a language parameter, for example looking up Gen.1.1 and Gen.2.1 in English, and exposes a Swagger docs page for exploring the API interactively.
How to install
For Claude Desktop, build the project and point Claude Desktop's MCP config at the resulting mcp-server.stdio.js file in the build folder. For the completions API:
docker build -f completions/Dockerfile -t mcp-server .
docker run -p 8002:8000 mcp-server
Then check it is running at http://localhost:8002/docs, or connect a client such as Open WebUI running a local model via Ollama.
Who it's for
Researchers, educators, and developers who want dependable, source-grounded Bible verse retrieval inside an LLM workflow, whether through Claude Desktop directly or through any client that speaks the OpenAI completions API. The project is licensed under GNU GPL v3.
Source README
ai-Bible
ai-Bible is a project that explores the use of AI within a context of interpreting and understanding biblical text. This repository contains mcp-servers and a container for compatibility with the openai completions API that support an AI or Large Language Model reliably and repeatably lookup data so that it can be represented in different forms for research or educational purposes with some confidence that results will be reproducable and reasonable.
For web accessible front end as a pocket bible see http://ai-bible.com
mcp-server for Claude etc
The mcp-server contains the current implementation of a server for repeatedly and reliably retrieving bible verses when using LLMs. Claude Desktop can be configured to use the mcp-server.stdio.js file built in the build folder of this project as an mcp-server.
See the README.md in that subfolder for detailed information.
docker-container for completions
The docker container wraps the mcp server up using mcpo in order to turn it into server supporting the openai completions api. Run these commands from the project root after building the mcp-server.
docker build -f completions/Dockerfile -t mcp-server .
docker run -p 8002:8000 mcp-server
You can check it is running be checking the swagger api page:
http://localhost:8002/docs
Try the get-verse api with parameters:
{
"reference": ["Gen.1.1", "Gen.2.1"],
"language": "english"
}
One way to access the completions api is via Open WebUI and then you can do everything locally with a LLM via Ollama with a model such as llama 3.1 8b, see:
https://docs.openwebui.com/getting-started/quick-start/
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.