<<<<<<< HEAD

Bible MCP Server

A Model Context Protocol (MCP) server that provides access to Bible verses and translations through the Bible API (https://bible-api.com/).

Features

• Get Random Verses: Retrieve random Bible verses from the entire Bible, Old Testament, New Testament, or specific books
• Get Specific Verses: Fetch specific Bible verses or passages by reference
• Multiple Translations: Support for 16+ Bible translations in various languages
• Browse Books and Chapters: List available books and chapters for any translation
• Translation Information: Get details about available Bible translations

Available Tools

1. get_random_bible_verse

Get a random Bible verse.

• Parameters:
  • book_ids (optional): Comma-separated book IDs (e.g., “GEN,JHN”) or “OT”/“NT”
• Example: Get random verse from New Testament: book_ids="NT"

2. get_bible_verse

Get a specific Bible verse or passage.

• Parameters:
  • reference (required): Bible reference (e.g., “John 3:16”, “Genesis 1:1-3”)
  • translation (optional): Translation identifier (default: “web”)
• Example: reference="John 3:16", translation="kjv"

3. list_bible_translations

Get list of all available Bible translations.

• No parameters required
• Returns: List of translations with identifiers, names, and languages

4. list_bible_books

Get list of books for a specific translation.

• Parameters:
  • translation (optional): Translation identifier (default: “web”)

5. list_bible_chapters

Get chapters for a specific Bible book.

• Parameters:
  • book (required): Book identifier (e.g., “JHN” for John)
  • translation (optional): Translation identifier (default: “web”)

Supported Translations

• English: World English Bible (web), King James Version (kjv), American Standard Version (asv), and more
• Other Languages: Chinese (cuv), Czech (bkr), Portuguese (almeida), Romanian (rccv), Latin (clementine), Cherokee (cherokee)

Installation

1. Clone this repository
2. Install dependencies:

   pip install -r requirements.txt
   

Usage

Running the Server

python -m server

Testing the API Functions

python test_bible_api.py

Example Responses

Random Verse

{
  "translation": {
    "identifier": "web",
    "name": "World English Bible",
    "language": "English"
  },
  "random_verse": {
    "book_id": "JHN",
    "book": "John",
    "chapter": 3,
    "verse": 16,
    "text": "For God so loved the world..."
  }
}

Specific Verse

{
  "reference": "John 3:16",
  "text": "For God so loved the world, that he gave his one and only Son...",
  "translation_id": "web",
  "translation_name": "World English Bible"
}

API Reference

This MCP server uses the Bible API (https://bible-api.com/) which provides:

• Public domain Bible texts
• Multiple translations and languages
• RESTful JSON API
• No authentication required

License

This project is open source. The Bible texts are in the public domain.

bible-mcp

Free Bible API with multiple languages

f40696de9c0e33bc1c8aae95c4e06c4d3f2d8cd5