README.md•4.67 kB
# Bible Korean MCP Server
[](https://github.com/oksure/bible-ko-mcp/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/bible-ko-mcp)
[](https://opensource.org/licenses/MIT)
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
```bash
npm install
npm run build
```
## 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:**
```json
{
"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:**
```json
{
"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:**
```json
{
"query": "사랑",
"version": "GAE"
}
```
### 4. `list-books`
List all available books in the Bible.
**Parameters:**
- `testament` (string, optional): Filter by testament ("OT" or "NT")
**Example:**
```json
{
"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:**
```json
{
"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`:
```json
{
"mcpServers": {
"bible-ko": {
"command": "node",
"args": ["/path/to/bible-ko-mcp/build/index.js"]
}
}
}
```
### Windows
Edit `%APPDATA%\Claude\claude_desktop_config.json`
## Development
```bash
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run watch
# Run
npm start
```
## 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](PUBLISHING.md) for detailed instructions.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
MIT