Uses FastAPI framework to provide REST API endpoints alongside MCP protocol support for Bible passage retrieval
Integrates with GitHub Copilot to enable AI-assisted Bible passage lookup and retrieval through natural language queries
Uses Pydantic models for data validation and type safety in Bible passage requests and configuration management
Built with Python 3.10+ runtime environment for Bible passage retrieval and MCP server functionality
Provides OpenAPI documentation through Swagger UI for exploring and testing Bible passage retrieval REST API endpoints
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 checkGET /info
- Service informationPOST /passage
- Get Bible passageGET /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 (orpip
)
Step 1: Install Dependencies
Step 2: Configure Environment
Usage
Run in MCP-only Mode (stdio)
Run in HTTP Mode with REST API
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:
Then ask Copilot:
"Show me John 3:16"
"What does Romans 8 say?"
"Read Psalm 23 in NIV"
Test the REST API
Project Structure
How It Works
Features Pattern (Automatic Discovery)
This server uses automatic feature discovery - just like mcp-weather
!
Add a new feature in 3 steps:
Create feature directory:
features/my_feature/
Add tool.py: With
register_tool(mcp, service)
functionAdd 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:
2. Business Logic Layer (bible_service.py)
Pure business logic, independent of MCP/REST:
3. MCP Service Wrapper (service.py)
Implements BaseService
to expose business logic via MCP:
4. Server Implementation (server.py)
Extends BaseMCPServer
to create the complete server:
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
:
Add New REST Endpoints
Edit mcp_bible/server.py
:
Add New Configuration
Edit mcp_bible/config.py
:
Troubleshooting
Import Errors
Make sure you're importing from core
, not mcp_weather.core
:
Module Not Found
Make sure mcp-weather is installed:
If not installed, install it:
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
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.