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:

Or use directly with npx (no installation required):

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:

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:

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:

4. list-books

List all available books in the Bible.

Parameters:

• testament (string, optional): Filter by testament ("OT" or "NT")

Example:

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:

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:

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:

Local Development with Claude Desktop

For testing local changes, use this configuration:

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

Contributing

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

License

MIT