kjb-mcp
v1.1.0
Published
MCP wrapper server for the Bible API (KJV only)
Readme
KJB MCP Server
A Model Context Protocol server that provides access to the King James Version (KJV) of the Bible. This server enables interaction with the Bible through MCP tools.
Prerequisites
- Node.js 16 or higher
- npm or yarn
Features
- Retrieve specific Bible verses by book, chapter, and verse
- Get entire chapters from the Bible
- List all available books in the KJV
- Search functionality for Bible verses (placeholder in current version)
- Lightweight and easy to integrate with MCP-compatible applications
Installation
# Install globally
npm install -g kjb-mcp
# Or use with npx
npx kjb-mcpUsage
In MCP Settings
Add the following to your MCP settings configuration:
{
"mcpServers": {
"kjb": {
"command": "npx",
"args": ["-y", "kjb-mcp"],
"disabled": false,
"autoApprove": []
}
}
}Windows CLI users may need the following:
{
"mcpServers": {
"kjb": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"kjb-mcp"
],
"disabled": false,
"autoApprove": []
}
}
}Available Tools
Bible Access
get_verse: Get a specific verse from the KJV Bibleget_chapter: Get an entire chapter from the KJV Biblelist_books: List all available books in the KJV Biblesearch_bible: Search for text in the KJV Bible (placeholder)
Function Details
get_verse
Get a specific verse from the King James Version of the Bible.
Parameters:
book(string): The book of the Bible (e.g., genesis, exodus, john)chapter(string): The chapter numberverse(string): The verse number
Example:
const result = await mcp.invoke('get_verse', {
book: 'john',
chapter: '3',
verse: '16'
});
// Returns: { verse: 'john 3:16', text: 'For God so loved the world...', version: 'en-kjv' }get_chapter
Get an entire chapter from the King James Version of the Bible.
Parameters:
book(string): The book of the Bible (e.g., genesis, exodus, john)chapter(string): The chapter number
Example:
const result = await mcp.invoke('get_chapter', {
book: 'psalms',
chapter: '23'
});
// Returns: { chapter: 'psalms 23', verses: [...], version: 'en-kjv' }list_books
List all available books in the King James Version of the Bible.
Example:
const result = await mcp.invoke('list_books', {});
// Returns: { books: [...], version: 'en-kjv' }search_bible
Search for verses containing specific text in the King James Version of the Bible. (Note: This is a placeholder function in the current version)
Parameters:
query(string): The text to search for in the Bible
Example:
const result = await mcp.invoke('search_bible', {
query: 'love your neighbor'
});Development
Starting the Server
import { startServer } from 'kjb-mcp';
// Start the server on the default port (3000)
startServer();
// Or specify a custom port
startServer(8080);License
MIT
