Ai Bible

What is Ai Bible about?

Ai Bible enables LLMs to look up biblical verses in a deterministic way. It ships an MCP server that returns verse text based on references, and a Docker‑wrapped service exposing the OpenAI completions endpoint, so any client that understands the OpenAI API can query biblical data without custom parsers.

How to use Ai Bible?

1. Build the MCP server – run the build process provided in the repository (e.g., npm run build).
2. Start the Docker container:

   docker build -f completions/Dockerfile -t mcp-server .
   docker run -p 8002:8000 mcp-server
   

3. Verify it’s running by opening http://localhost:8002/docs and trying the get‑verse endpoint with JSON payload like:

   { "reference": ["Gen.1.1", "Gen.2.1"], "language": "english" }
   

4. Configure any LLM client (Claude Desktop, Open WebUI, Ollama, etc.) to point to the local server (http://localhost:8002).

Key features of Ai Bible

• Deterministic verse lookup via MCP protocol.
• OpenAI‑compatible completions API wrapped in a Docker container.
• Language selection (currently English; extensible).
• Easy integration with Claude Desktop, Open WebUI, Ollama, and any OpenAI‑compatible client.
• Swagger UI for interactive testing.

Use cases of Ai Bible

• Academic research requiring reproducible biblical citations.
• Educational tools that need reliable verse retrieval.
• Building custom AI assistants that reference scripture accurately.
• Integrating biblical knowledge into chatbots or question‑answering systems.

FAQ from the Ai Bible project

Q: Do I need an OpenAI API key?
A: No. The container provides its own OpenAI‑compatible endpoint that works locally.

Q: Which LLMs are supported?
A: Any model that can call an OpenAI completions endpoint – e.g., Claude Desktop, Ollama models (Llama 3.1 8B, etc.).

Q: Can I add other languages?
A: The server accepts a language parameter; adding new translations involves extending the data files.

Q: How is the service licensed?
A: The source code is under GNU GPL v3; data files may have separate licenses (see LICENCE.md).

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/

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for any enhancements or bug fixes.

License

This project source code is under the GNU GPL v3 Licence. Within the project there are data files that come under different licences. See the file LICENCE.md for details of the GPL licence.