Skip to main content
Glama
Bible Korean MCP Server

Bible Korean MCP Server

by oksure

Bible Korean MCP Server

CI NPM Version License: MIT

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 16

See 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-mcp

Or use directly with npx (no installation required):

npx -y bible-ko-mcp

Available Tools

1. get-chapter

Get all verses from a specific chapter.

Parameters:

  • book (string, required): Book name in English, Korean, or book code

    • Examples: "Genesis", "μ°½μ„ΈκΈ°", "gen"

  • chapter (number, required): Chapter number

  • version (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 code

  • chapter (number, required): Chapter number

  • verseStart (number, required): Starting verse number

  • verseEnd (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 English

  • version (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 code

  • chapter (number, required): Chapter number

  • verse (number, required): Verse number

  • versions (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 (μ°½μ„ΈκΈ°): gen

  • Exodus (μΆœμ• κ΅½κΈ°): exo

  • Leviticus (λ ˆμœ„κΈ°): lev

  • Numbers (민수기): num

  • Deuteronomy (μ‹ λͺ…κΈ°): deu

  • ... (see full list in source code)

New Testament

  • Matthew (λ§ˆνƒœλ³΅μŒ): mat

  • Mark (λ§ˆκ°€λ³΅μŒ): mrk

  • Luke (λˆ„κ°€λ³΅μŒ): luk

  • John (μš”ν•œλ³΅μŒ): jhn

  • Acts (사도행전): 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 start

Local 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: 12

Good Friday β€” Messianic prophecy from Isaiah

Tool: get-chapter
Book: Isaiah, Chapter: 53, Version: GAE

Christmas Eve sermon β€” The nativity narrative

Tool: get-verses
Book: Luke, Chapter: 2, Start: 1, End: 20

Easter Sunday β€” The resurrection account

Tool: get-chapter
Book: John, Chapter: 20, Version: GAE

Wedding homily β€” The Love Chapter

Tool: get-chapter
Book: 1 Corinthians, Chapter: 13, Version: GAE

Missions Sunday β€” The Great Commission

Tool: get-verses
Book: Matthew, Chapter: 28, Start: 18, End: 20

Bible 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: 26

Fruit of the Spirit study

Tool: get-verses
Book: Galatians, Chapter: 5, Start: 22, End: 23

Hebrews 11 "Faith Hall of Fame" β€” full chapter

Tool: get-chapter
Book: Hebrews, Chapter: 11, Version: GAE

Spiritual warfare β€” full armor of God passage

Tool: get-verses
Book: Ephesians, Chapter: 6, Start: 10, End: 18

Personal Devotional

Psalm 23 for comfort (funeral message, hospital visits)

Tool: get-chapter
Book: Psalms, Chapter: 23, Version: GAE

Romans 8:28-39 β€” Assurance of God's love

Tool: get-verses
Book: Romans, Chapter: 8, Start: 28, End: 39

Daily scripture memory verse

Tool: get-verses
Book: Philippians, Chapter: 4, Start: 13, End: 13

Advent devotional β€” The Word became flesh

Tool: get-verses
Book: John, Chapter: 1, Start: 1, End: 14

Korean Language Look-up

All tools accept Korean book names, making it natural to reference Scripture in Korean:

Tool: get-chapter
Book: μ‹œνŽΈ (Psalms), Chapter: 23
Tool: get-verses
Book: μž μ–Έ (Proverbs), Chapter: 3, Start: 5, End: 6
Tool: 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 tools
compare-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

    A3.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    With 6 tools, the server is well-scoped for its domain, covering reading, searching, and comparison without being overly numerous or too sparse.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      4
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.
      1
      -