oksure/bible-ko-mcp

Bible Korean MCP Server

MCP (Model Context Protocol) server for accessing the Korean Bible from bskorea.or.kr.

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

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: For demo purposes, search is limited to a few books and chapters.

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
• Supports all 66 books of the Bible
• Handles Korean and English book names

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 for detailed instructions.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT