Bible Korean MCP Server
韩国圣经 MCP 服务器
用于访问 bskorea.or.kr 韩国圣经的 MCP (Model Context Protocol) 服务器。
功能特点:
⚡️ 内存缓存:30 分钟 TTL,实现快速重复请求
🔄 自动重试:指数退避策略(3 次重试,1秒→2秒→4秒),应对瞬时故障
🛡️ 稳健的错误处理:使用 try/catch 和优雅的降级处理
✅ 输入验证:使用 Zod 模式进行验证
🏥 健康检查:用于监控的工具
📚 全书 66 卷:支持 5 种译本
🔍 全文搜索:覆盖整本圣经
Node.js 版本
需要 Node.js 20+
Related MCP server: biblebridge-mcp
功能
此 MCP 服务器提供的工具可以:
获取韩国圣经的完整章节
检索特定经文或经文范围
搜索包含关键词的经文
列出所有可用的书卷
比较不同韩国译本的经文
安装
通过 npm 全局安装:
npm install -g bible-ko-mcp或者直接使用 npx(无需安装):
npx -y bible-ko-mcp可用工具
1. get-chapter
获取特定章节的所有经文。
参数:
book(string, 必填): 英文、韩文书名或书卷代码示例: "Genesis", "창세기", "gen"
chapter(number, 必填): 章节号version(string, 可选): 圣经译本版本 (默认: "GAE")选项: "GAE", "GAE1", "NIR", "KOR", "CEV"
示例:
{
"book": "Genesis",
"chapter": 1,
"version": "GAE"
}2. get-verses
获取章节中的特定经文。
参数:
book(string, 必填): 书名或代码chapter(number, 必填): 章节号verseStart(number, 必填): 起始经文号verseEnd(number, 可选): 结束经文号 (默认为 verseStart)version(string, 可选): 圣经译本版本 (默认: "GAE")
示例:
{
"book": "John",
"chapter": 3,
"verseStart": 16,
"verseEnd": 17,
"version": "GAE"
}3. search-bible
搜索包含特定关键词的经文。
参数:
query(string, 必填): 韩文或英文搜索查询version(string, 可选): 圣经译本版本 (默认: "GAE")
注意: 搜索覆盖圣经全部 66 卷书,并提供回退结果。
示例:
{
"query": "사랑",
"version": "GAE"
}4. list-books
列出圣经中所有可用的书卷。
参数:
testament(string, 可选): 按约过滤 ("OT" 或 "NT")
示例:
{
"testament": "NT"
}5. compare-translations
比较不同韩国译本中的同一节经文。
参数:
book(string, 必填): 书名或代码chapter(number, 必填): 章节号verse(number, 必填): 经文号versions(array, 可选): 要比较的版本代码数组 (默认: 所有版本)
示例:
{
"book": "John",
"chapter": 3,
"verse": 16,
"versions": ["GAE", "NIR", "KOR"]
}圣经译本
GAE: 개역개정 (修订版韩文标准译本)
GAE1: 개역한글 (韩文修订版)
NIR: 새번역성경 (新韩文修订版)
KOR: 공동번역 (共同译本)
CEV: CEV (当代英语译本)
书卷代码
旧约
Genesis (창세기):
genExodus (출애굽기):
exoLeviticus (레위기):
levNumbers (민수기):
numDeuteronomy (신명기):
deu... (查看源代码中的完整列表)
新约
Matthew (마태복음):
matMark (마가복음):
mrkLuke (누가복음):
lukJohn (요한복음):
jhnActs (사도행전):
act... (查看源代码中的完整列表)
与 Claude Desktop 一起使用
添加到您的 Claude Desktop 配置中:
macOS
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bible-ko": {
"command": "npx",
"args": [
"-y",
"bible-ko-mcp"
]
}
}
}Windows
使用上述相同配置编辑 %APPDATA%\Claude\claude_desktop_config.json。
添加配置后,请完全重启 Claude Desktop。
开发
本地开发:
# 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使用 Claude Desktop 进行本地开发
测试本地更改时,请使用此配置:
{
"mcpServers": {
"bible-ko": {
"command": "node",
"args": [
"/absolute/path/to/bible-ko-mcp/build/index.js"
]
}
}
}请记住在进行更改后运行 npm run build。
技术细节
使用 TypeScript 和 MCP SDK 构建
使用 cheerio 进行 HTML 解析
从 bskorea.or.kr 获取数据,并在瞬时故障时自动重试(指数退避)
内存缓存(30 分钟 TTL,2000 条目)避免冗余请求
支持全部 66 卷圣经
处理韩文和英文书名
使用场景
讲道准备
每周日关于八福的讲道
询问 Claude: "请给我马太福音 5:3-12 的韩文 (GAE) 版本,并将每一条福分单独列行,以便我准备讲道大纲。"
Tool: get-verses
Book: Matthew, Chapter: 5, Start: 3, End: 12受难日 — 以赛亚书中的弥赛亚预言
Tool: get-chapter
Book: Isaiah, Chapter: 53, Version: GAE平安夜讲道 — 降生叙事
Tool: get-verses
Book: Luke, Chapter: 2, Start: 1, End: 20复活节主日 — 复活记载
Tool: get-chapter
Book: John, Chapter: 20, Version: GAE婚礼证道 — 爱之篇章
Tool: get-chapter
Book: 1 Corinthians, Chapter: 13, Version: GAE宣教主日 — 大使命
Tool: get-verses
Book: Matthew, Chapter: 28, Start: 18, End: 20查经小组
比较约翰福音 3:16 的不同译本以进行小组讨论
Tool: compare-translations
Book: John, Chapter: 3, Verse: 16
Versions: ["GAE", "GAE1", "NIR", "KOR"]专题研究:活泼的信心 (야고보서의 믿음)
Tool: get-verses
Book: James, Chapter: 2, Start: 14, End: 26圣灵果子研究
Tool: get-verses
Book: Galatians, Chapter: 5, Start: 22, End: 23希伯来书 11 章“信心伟人榜” — 完整章节
Tool: get-chapter
Book: Hebrews, Chapter: 11, Version: GAE属灵争战 — 全副军装经文
Tool: get-verses
Book: Ephesians, Chapter: 6, Start: 10, End: 18个人灵修
诗篇 23 篇以获得安慰(葬礼信息、探访病人)
Tool: get-chapter
Book: Psalms, Chapter: 23, Version: GAE罗马书 8:28-39 — 神爱的确据
Tool: get-verses
Book: Romans, Chapter: 8, Start: 28, End: 39每日经文背诵
Tool: get-verses
Book: Philippians, Chapter: 4, Start: 13, End: 13将临期灵修 — 道成了肉身
Tool: get-verses
Book: John, Chapter: 1, Start: 1, End: 14韩语查询
所有工具都接受韩文书名,使得引用韩文圣经变得非常自然:
Tool: get-chapter
Book: 시편 (Psalms), Chapter: 23Tool: get-verses
Book: 잠언 (Proverbs), Chapter: 3, Start: 5, End: 6Tool: search-bible
Query: 하나님의 사랑 (God's love)注意事项
HTML 解析可能需要根据网站更新进行调整
搜索功能为演示目的进行了限制,以避免过多的请求
某些译本可能并非所有书卷都可用
发布
当创建新的 GitHub 发布时,此包会自动发布到 NPM。详细说明请参阅 PUBLISHING.md。
贡献
欢迎贡献!请随时提交 Pull Request。
许可证
MIT
Available Tools
6 toolscompare-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
Scored across 6 tools
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.
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.
With 6 tools, the server is well-scoped for its domain, covering reading, searching, and comparison without being overly numerous or too sparse.
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
Related MCP Connectors
Bible translations, books, chapters, verses, and search
Unofficial Bible MCP — wraps the Bible API (free, no auth) https://bible-api.com
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides 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.4MIT
- AlicenseNot gradedqualityNot gradedmaintenanceProvides 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-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.1-
- AlicenseNot gradedqualityDmaintenanceExposes Bible content from bible-api.com for LLMs, enabling retrieval of verses, chapters, random verses, and Bible study prompts with support for multiple translations.21 PyPI17MIT