Skip to main content
Glama
Bible Korean MCP Server

Bible Korean MCP Server

by oksure

韩国圣经 MCP 服务器

CI NPM Version License: MIT

用于访问 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 (창세기): gen

  • Exodus (출애굽기): exo

  • Leviticus (레위기): lev

  • Numbers (민수기): num

  • Deuteronomy (신명기): deu

  • ... (查看源代码中的完整列表)

新约

  • Matthew (마태복음): mat

  • Mark (마가복음): mrk

  • Luke (누가복음): luk

  • John (요한복음): jhn

  • Acts (사도행전): 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: 23
Tool: get-verses
Book: 잠언 (Proverbs), Chapter: 3, Start: 5, End: 6
Tool: search-bible
Query: 하나님의 사랑 (God's love)

注意事项

  • HTML 解析可能需要根据网站更新进行调整

  • 搜索功能为演示目的进行了限制,以避免过多的请求

  • 某些译本可能并非所有书卷都可用

发布

当创建新的 GitHub 发布时,此包会自动发布到 NPM。详细说明请参阅 PUBLISHING.md。

贡献

欢迎贡献!请随时提交 Pull Request。

许可证

MIT

Available Tools

6 tools
compare-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

    A3.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    With 6 tools, the server is well-scoped for its domain, covering reading, searching, and comparison without being overly numerous or too sparse.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      4
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.
      1
      -