Skip to main content
Glama

Bible MCP Server

by geosp
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Bible MCP Server

A Model Context Protocol (MCP) server that provides Bible passage retrieval functionality using the mcp-weather core infrastructure.

This server enables AI assistants to access Bible passages from various translations, with both MCP protocol support and REST API endpoints.

Features

The Bible MCP Server provides:

MCP Tools (for AI assistants)

  • get_passage(passage, version) - Retrieve Bible passages. Supports multiple passages separated by semicolons (e.g., "John 3:16; Romans 8:28").

REST API Endpoints

  • GET /health - Health check

  • GET /info - Service information

  • POST /passage - Get Bible passage

  • GET /docs - OpenAPI documentation (Swagger UI)

Supported Bible Versions

  • ESV (English Standard Version)

  • NIV (New International Version)

  • KJV (King James Version)

  • NASB (New American Standard Bible)

  • NKJV (New King James Version)

  • NLT (New Living Translation)

  • AMP (Amplified Bible)

  • MSG (The Message)

Installation

Prerequisites

  • Python 3.10+

  • uv package manager (or pip)

Step 1: Install Dependencies

# From this directory cd mcp-bible # Install dependencies uv sync

Step 2: Configure Environment

# Copy example configuration cp .env.example .env # Edit .env with your settings nano .env

Usage

Run in MCP-only Mode (stdio)

# Set transport to stdio in .env export MCP_TRANSPORT=stdio export MCP_ONLY=true # Run the server python -m mcp_bible.server

Run in HTTP Mode with REST API

# Set transport to HTTP in .env export MCP_TRANSPORT=http export MCP_ONLY=false export MCP_PORT=3000 # Run the server python -m mcp_bible.server

The server will start at http://localhost:3000 with:

  • MCP endpoint: http://localhost:3000/mcp

  • REST API: http://localhost:3000/*

  • API docs: http://localhost:3000/docs

  • Health check: http://localhost:3000/health

Test the MCP Tools

You can test the MCP tools by connecting GitHub Copilot or using a test client:

// .vscode/mcp.json { "servers": { "bible": { "type": "http", "url": "http://localhost:3000/mcp" } } }

Then ask Copilot:

  • "Show me John 3:16"

  • "What does Romans 8 say?"

  • "Read Psalm 23 in NIV"

Test the REST API

# Health check curl http://localhost:3000/health # Get service info curl http://localhost:3000/info # Get a Bible passage curl -X POST "http://localhost:3000/passage" \ -H "Content-Type: application/json" \ -d '{ "passage": "John 3:16", "version": "ESV" }'

Project Structure

mcp_bible/ ├── __init__.py # Package metadata ├── config.py # Configuration management ├── bible_service.py # Business logic (Bible API client) ├── service.py # MCP service wrapper (with feature discovery) ├── server.py # Server implementation ├── features/ # Feature modules (MODULAR PATTERN) │ ├── __init__.py │ ├── get_passage/ # Get passage feature │ │ ├── __init__.py │ │ ├── models.py # Feature-specific models │ │ ├── tool.py # MCP tool definition │ │ └── routes.py # REST API endpoints └── shared/ # Shared models and utilities ├── __init__.py └── models.py # Base models, error types

How It Works

Features Pattern (Automatic Discovery)

This server uses automatic feature discovery - just like mcp-weather!

Add a new feature in 3 steps:

  1. Create feature directory: features/my_feature/

  2. Add tool.py: With register_tool(mcp, service) function

  3. Add routes.py (optional): With create_router(service) function

That's it! The service automatically:

  • Discovers your feature

  • Registers MCP tools from tool.py

  • Includes REST routes from routes.py

No manual registration needed!

1. Configuration Layer (config.py)

Extends core configuration classes with service-specific settings:

from core.config import BaseServerConfig class BibleAPIConfig(BaseModel): base_url: str supported_versions: List[str] class AppConfig(BaseModel): server: ServerConfig bible_api: BibleAPIConfig

2. Business Logic Layer (bible_service.py)

Pure business logic, independent of MCP/REST:

class BibleService: async def fetch_passage(self, passage: str, version: str) -> dict: # Bible passage retrieval logic here ...

3. MCP Service Wrapper (service.py)

Implements BaseService to expose business logic via MCP:

from core.server import BaseService class BibleMCPService(BaseService): def register_mcp_tools(self, mcp: FastMCP) -> None: # Automatic feature discovery and registration

4. Server Implementation (server.py)

Extends BaseMCPServer to create the complete server:

from core.server import BaseMCPServer class BibleMCPServer(BaseMCPServer): @property def service_title(self) -> str: return "Bible MCP Server" def create_router(self) -> APIRouter: # Add REST endpoints ...

Key Benefits of Using mcp-weather Core

By using mcp-weather as a dependency, you get:

✅ No boilerplate - Server infrastructure is ready to use ✅ Dual interfaces - MCP + REST API automatically ✅ Configuration - Environment variable management ✅ Error handling - Comprehensive exception handling ✅ Type safety - Full Pydantic models and type hints ✅ Async support - Async-first design throughout ✅ Logging - Structured logging built-in ✅ CORS - Configurable CORS support ✅ Health checks - Standard endpoints

Customization

Add New MCP Tools

Edit mcp_bible/service.py:

def register_mcp_tools(self, mcp: FastMCP) -> None: @mcp.tool() async def my_new_tool(param: str) -> dict: """Tool description for AI""" return {"result": "value"}

Add New REST Endpoints

Edit mcp_bible/server.py:

def create_router(self) -> APIRouter: router = APIRouter() @router.get("/my-endpoint") async def my_endpoint(): return {"data": "value"} return router

Add New Configuration

Edit mcp_bible/config.py:

class BibleAPIConfig(BaseModel): my_new_field: str = Field(default="value")

Troubleshooting

Import Errors

Make sure you're importing from core, not mcp_weather.core:

from core.server import BaseMCPServer # ✅ Correct from mcp_weather.core.server import BaseMCPServer # ❌ Wrong

Module Not Found

Make sure mcp-weather is installed:

uv pip list | grep mcp-weather

If not installed, install it:

uv sync # Installs from pyproject.toml

Next Steps

  • Add real Bible API integration

  • Add more Bible versions

  • Implement passage search

  • Add daily verses

  • Implement caching

  • Add metrics and monitoring

Learn More

License

This project is provided as-is for use and modification.

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI assistants to retrieve Bible passages from multiple translations (ESV, NIV, KJV, NASB, NKJV, NLT, AMP, MSG). Supports querying single or multiple passages and provides both MCP protocol integration and REST API endpoints.

  1. Features
    1. MCP Tools (for AI assistants)
    2. REST API Endpoints
    3. Supported Bible Versions
  2. Installation
    1. Prerequisites
    2. Step 1: Install Dependencies
    3. Step 2: Configure Environment
  3. Usage
    1. Run in MCP-only Mode (stdio)
    2. Run in HTTP Mode with REST API
    3. Test the MCP Tools
    4. Test the REST API
  4. Project Structure
    1. How It Works
      1. Features Pattern (Automatic Discovery)
      2. 1. Configuration Layer (config.py)
      3. 2. Business Logic Layer (bible_service.py)
      4. 3. MCP Service Wrapper (service.py)
      5. 4. Server Implementation (server.py)
    2. Key Benefits of Using mcp-weather Core
      1. Customization
        1. Add New MCP Tools
        2. Add New REST Endpoints
        3. Add New Configuration
      2. Troubleshooting
        1. Import Errors
        2. Module Not Found
      3. Next Steps
        1. Learn More
          1. License

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/geosp/mcp-bible'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server