Bible Korean MCP Server
This MCP server provides comprehensive access to the Korean Bible with tools for retrieving, searching, and comparing biblical content across multiple translations.
Core Features:
Retrieve chapters and verses: Get complete chapters or specific verses/ranges using flexible book identification (English names, Korean names, or book codes)
Search biblical content: Find verses containing specific keywords in Korean or English
Compare translations: Analyze verses across five Korean Bible versions (GAE, GAE1, NIR, KOR, CEV) with GAE as default
Browse books: List all Bible books with optional Old Testament/New Testament filtering
Key Benefits:
Supports multiple Korean Bible translations
Flexible input methods for book identification
Keyword search in both Korean and English
Cross-translation comparison capabilities
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bible Korean MCP Server show me John 3:16 in Korean"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bible Korean MCP Server
MCP (Model Context Protocol) server for accessing the Korean Bible from bskorea.or.kr.
Features:
β‘οΈ In-memory caching with 30-min TTL for fast repeated requests
π Automatic retry with exponential backoff (3 retries, 1sβ2sβ4s) for transient failures
π‘οΈ Robust error handling with try/catch and graceful fallbacks
β Input validation with Zod schemas
π₯ Health check tool for monitoring
π All 66 books with 5 translations supported
π Full-text search across entire Bible
Node.js Version
Requires Node.js 20+
Related MCP server: biblebridge-mcp
Features
This MCP server provides tools to:
Get complete chapters from the Korean Bible
Retrieve specific verses or verse ranges
Search for verses containing keywords
List all available books
Compare verses across different Korean translations
Use as a Claude Skill (lightweight alternative)
The same Korean Bible access is also packaged as a Claude Skill under
skill/ β a token-frugal alternative to the always-on MCP server. A
skill loads into the agent's context only when invoked and shells out to a small
zero-dependency Python CLI, so it costs nothing while idle. Use the MCP server
in MCP clients (Claude Desktop, TypingMind); use the skill in coding agents
(Claude Code, etc.) that already have shell access.
chmod +x skill/bin/bible && export PATH="$PWD/skill/bin:$PATH"
bible verses John 3 16
bible compare John 3 16See skill/README.md for install and the MCP-vs-skill
trade-off. (The industry is steadily shifting routine API access from always-on
MCP servers toward on-demand skills β this repo ships both.)
Installation
Install globally via npm:
npm install -g bible-ko-mcpOr use directly with npx (no installation required):
npx -y bible-ko-mcpAvailable Tools
1. get-chapter
Get all verses from a specific chapter.
Parameters:
book(string, required): Book name in English, Korean, or book codeExamples: "Genesis", "μ°½μΈκΈ°", "gen"
chapter(number, required): Chapter numberversion(string, optional): Bible translation version (default: "GAE")Options: "GAE", "GAE1", "NIR", "KOR", "CEV"
Example:
{
"book": "Genesis",
"chapter": 1,
"version": "GAE"
}2. get-verses
Get specific verse(s) from a chapter.
Parameters:
book(string, required): Book name or codechapter(number, required): Chapter numberverseStart(number, required): Starting verse numberverseEnd(number, optional): Ending verse number (defaults to verseStart)version(string, optional): Bible translation version (default: "GAE")
Example:
{
"book": "John",
"chapter": 3,
"verseStart": 16,
"verseEnd": 17,
"version": "GAE"
}3. search-bible
Search for verses containing specific keywords.
Parameters:
query(string, required): Search query in Korean or Englishversion(string, optional): Bible translation version (default: "GAE")
Note: Search covers all 66 books of the Bible with fallback results.
Example:
{
"query": "μ¬λ",
"version": "GAE"
}4. list-books
List all available books in the Bible.
Parameters:
testament(string, optional): Filter by testament ("OT" or "NT")
Example:
{
"testament": "NT"
}5. compare-translations
Compare a verse across different Korean translations.
Parameters:
book(string, required): Book name or codechapter(number, required): Chapter numberverse(number, required): Verse numberversions(array, optional): Array of version codes to compare (default: all versions)
Example:
{
"book": "John",
"chapter": 3,
"verse": 16,
"versions": ["GAE", "NIR", "KOR"]
}Bible Translations
GAE: κ°μκ°μ (Revised Korean Standard Version)
GAE1: κ°μνκΈ (Korean Revised Version)
NIR: μλ²μμ±κ²½ (New Korean Revised Version)
KOR: 곡λλ²μ (Common Translation)
CEV: CEV (Contemporary English Version)
Book Codes
Old Testament
Genesis (μ°½μΈκΈ°):
genExodus (μΆμ κ΅½κΈ°):
exoLeviticus (λ μκΈ°):
levNumbers (λ―ΌμκΈ°):
numDeuteronomy (μ λͺ κΈ°):
deu... (see full list in source code)
New Testament
Matthew (λ§ν볡μ):
matMark (λ§κ°λ³΅μ):
mrkLuke (λκ°λ³΅μ):
lukJohn (μν볡μ):
jhnActs (μ¬λνμ ):
act... (see full list in source code)
Usage with Claude Desktop
Add to your Claude Desktop configuration:
macOS
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bible-ko": {
"command": "npx",
"args": [
"-y",
"bible-ko-mcp"
]
}
}
}Windows
Edit %APPDATA%\Claude\claude_desktop_config.json with the same configuration above.
After adding the configuration, restart Claude Desktop completely.
Development
For local development:
# Clone the repository
git clone https://github.com/oksure/bible-ko-mcp.git
cd bible-ko-mcp
# Install dependencies
npm install
# Build
npm run build
# Run tests
npm test
# Watch mode (auto-rebuild on changes)
npm run watch
# Run locally
npm startLocal Development with Claude Desktop
For testing local changes, use this configuration:
{
"mcpServers": {
"bible-ko": {
"command": "node",
"args": [
"/absolute/path/to/bible-ko-mcp/build/index.js"
]
}
}
}Remember to run npm run build after making changes.
Technical Details
Built with TypeScript and the MCP SDK
Uses cheerio for HTML parsing
Fetches data from bskorea.or.kr with automatic retry (exponential backoff) on transient failures
In-memory cache (30-min TTL, 2000 entries) avoids redundant requests
Supports all 66 books of the Bible
Handles Korean and English book names
Use Cases
Sermon Preparation
Weekly Sunday sermon with the Beatitudes
Ask Claude: "Give me Matthew 5:3-12 in Korean (GAE) with each beatitude on a separate line for my sermon outline."
Tool: get-verses
Book: Matthew, Chapter: 5, Start: 3, End: 12Good Friday β Messianic prophecy from Isaiah
Tool: get-chapter
Book: Isaiah, Chapter: 53, Version: GAEChristmas Eve sermon β The nativity narrative
Tool: get-verses
Book: Luke, Chapter: 2, Start: 1, End: 20Easter Sunday β The resurrection account
Tool: get-chapter
Book: John, Chapter: 20, Version: GAEWedding homily β The Love Chapter
Tool: get-chapter
Book: 1 Corinthians, Chapter: 13, Version: GAEMissions Sunday β The Great Commission
Tool: get-verses
Book: Matthew, Chapter: 28, Start: 18, End: 20Bible Study Groups
Comparing John 3:16 across translations for group discussion
Tool: compare-translations
Book: John, Chapter: 3, Verse: 16
Versions: ["GAE", "GAE1", "NIR", "KOR"]Topical study: Living Faith (μΌκ³ 보μμ λ―Ώμ)
Tool: get-verses
Book: James, Chapter: 2, Start: 14, End: 26Fruit of the Spirit study
Tool: get-verses
Book: Galatians, Chapter: 5, Start: 22, End: 23Hebrews 11 "Faith Hall of Fame" β full chapter
Tool: get-chapter
Book: Hebrews, Chapter: 11, Version: GAESpiritual warfare β full armor of God passage
Tool: get-verses
Book: Ephesians, Chapter: 6, Start: 10, End: 18Personal Devotional
Psalm 23 for comfort (funeral message, hospital visits)
Tool: get-chapter
Book: Psalms, Chapter: 23, Version: GAERomans 8:28-39 β Assurance of God's love
Tool: get-verses
Book: Romans, Chapter: 8, Start: 28, End: 39Daily scripture memory verse
Tool: get-verses
Book: Philippians, Chapter: 4, Start: 13, End: 13Advent devotional β The Word became flesh
Tool: get-verses
Book: John, Chapter: 1, Start: 1, End: 14Korean Language Look-up
All tools accept Korean book names, making it natural to reference Scripture in Korean:
Tool: get-chapter
Book: μνΈ (Psalms), Chapter: 23Tool: get-verses
Book: μ μΈ (Proverbs), Chapter: 3, Start: 5, End: 6Tool: search-bible
Query: νλλμ μ¬λ (God's love)Notes
The HTML parsing may need adjustment based on website updates
Search functionality is limited for demo purposes to avoid excessive requests
Some translations may not be available for all books
Publishing
This package is automatically published to NPM when a new GitHub release is created. See PUBLISHING.md for detailed instructions.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT
Available Tools
6 toolscompare-translationsA
Compare a verse across different Korean translations
Inputs: book (required), verse (required), chapter (required), versions.
get-chapterA
Get all verses from a specific chapter of the Korean Bible
Inputs: book (required), chapter (required), version.
get-versesC
Get specific verse(s) from a chapter
Inputs: book (required), chapter (required), verseStart (required), version, +1 more.
health-checkA
Check the health status of the Bible Korean MCP server and API connectivity
Inputs: no named parameters.
list-booksA
List all available books in the Bible
Inputs: testament.
search-bibleA
Search for verses containing specific keywords. Searches the first 10 chapters of each book β not a full-Bible search.
Inputs: query (required), version.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: compare-translations for cross-translation comparison, get-chapter for full chapters, get-verses for specific verses, health-check for server status, list-books for book listing, and search-bible for keyword search. No overlap.
Tool names follow a consistent pattern of lowercase hyphenated verb-noun (compare-translations, get-chapter, get-verses, list-books, search-bible), though health-check is a noun-noun compound, deviating slightly but still readable.
With 6 tools, the server is well-scoped for its domain, covering reading, searching, and comparison without being overly numerous or too sparse.
Core operations are covered (list books, get chapter/verses, search, compare), but notable gaps exist: no tool to list available translations, and the search is limited to the first 10 chapters of each book, which may hinder full-text discovery.
Maintenance
Related MCP Connectors
Bible translations, books, chapters, verses, and search
Unofficial Bible MCP β wraps the Bible API (free, no auth) https://bible-api.com
Korean law: statutes, precedents, ordinances, treaties and citation verification (λ²μ μ² API).
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides comprehensive Biblical research tools including scripture lookup, interlinear Greek/Hebrew data, and Strong's concordance within a Protestant theological framework. It enables AI applications to perform full-text biblical searches, topical studies, and cross-referencing using authoritative theological data.4MIT
- AlicenseNot gradedqualityNot gradedmaintenanceProvides structured access to Scripture through the BibleBridge API, enabling semantic search, contextual verse retrieval, and cross-reference analysis. It supports natural language reference normalization and comparative theological exploration across different passages.1-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.1-
- AlicenseNot gradedqualityDmaintenanceExposes Bible content from bible-api.com for LLMs, enabling retrieval of verses, chapters, random verses, and Bible study prompts with support for multiple translations.21 PyPI17MIT