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 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: 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 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 (창세기):
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 PUBLISHING.md for detailed instructions.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT