Bible MCP Server

A public MCP (Model Context Protocol) server that provides Bible verse lookup and search capabilities, powered by a custom Bible API hosted on Cloudflare Workers with D1.

Documentation: https://tuxr.github.io/bible-mcp MCP Endpoint: https://bible-mcp.dws-cloud.com/mcp

Features

• 📖 Get Verse - Retrieve any verse, range, or chapter

• 🔍 Search Bible - Full-text search with book/testament filters

• 📚 List Books - Browse all 86 books including Apocrypha

• 🌍 Multiple Translations - KJV and World English Bible

• 🎲 Random Verse - With optional book/testament filters

Related MCP server: quran-mcp-server

Available Tools

Supported Translations

• web - World English Bible (default)

• kjv - King James Version

Development

Prerequisites

• Node.js 18+

• A Cloudflare account (for deployment)

Setup

npm install
npm run dev

Your MCP server will be running at http://localhost:8787/mcp

Testing with MCP Inspector

npm run inspect

Then enter http://localhost:8787/mcp in the inspector.

Deployment

npm run deploy

Connecting to Claude.ai

1. Go to Claude.ai Settings → Connectors

2. Add the MCP server URL: https://bible-mcp.dws-cloud.com/mcp

3. The Bible tools will now be available in your conversations

Example Usage

Once connected, you can ask Claude things like:

• "Look up John 3:16"

• "Read Romans 14:14, 22-23" (comma-separated with context inheritance)

• "Search the Bible for 'faith' in the New Testament"

• "Show me a random Psalm"

• "List the books of the Apocrypha"

• "Get Romans 8:28-39 in KJV"

Architecture

graph LR
    Client([Claude.ai]) -->|MCP Protocol| MCP[MCP Worker]
    MCP -->|HTTPS or Service Binding| API[Bible API]
    API -->|SQL| D1[(D1 Database)]

• MCP Server: Cloudflare Worker with MCP protocol handler

• Bible API: REST API providing verse data (GitHub)

• Database: Cloudflare D1 with 74,000+ verses

• Search: Full-text search via FTS5 index

API Connection Options

The MCP server can connect to the Bible API in two ways:

Using the public API (default):

[vars]
BIBLE_API_URL = "https://bible-api.dws-cloud.com"

Using a service binding (same account):

[[services]]
binding = "BIBLE_API"
service = "your-bible-api-worker-name"  # Your worker's name

Note: The binding must be BIBLE_API (this matches the code). The service is whatever you named your Bible API worker when you deployed it.

License

MIT