bible-mcp

bible-mcp

面向基督教研究与学术工作的 MCP 服务。非商业项目，旨在成为公共资源。完整的来源与许可证概况请参见 corpus-survey.md，项目方向请参见 ROADMAP.md。

包含内容（v0.14）

数据	来源	许可证
Berean Standard Bible（66 卷）	berean.bible	公共领域
World English Bible，合订版（83 卷，含次经）	ebible.org	公共领域
七十士译本（Brenton 译本，1851 年）——旧约 + 次经，包括作为独立书卷的《苏撒拿》《比勒与大龙》和《耶利米书信》；诗篇按标准英文／KJV 编号重新映射（七十士译本自身的编号在诗篇的大部分内容中都不一致——已逐节与 WEB 核实）；《耶利米书》《但以理书（希腊文）》《出埃及记》《约伯记》《以斯帖记（希腊文）》和《巴录书》保留 Brenton 原有的七十士译本章节／经节结构，这些书卷的结构与 BSB/WEB 不同（存在重新编排和／或篇幅差异，而不只是编号不同）	ebible.org	公共领域
七十士译本，希腊文文本（Swete 版本，剑桥，1887–1894 年）——《创世记》至《玛拉基书》及次经、《但以理书（狄奥多田译本）》《苏撒拿》《比勒》；诗篇重新映射和原生结构注意事项与上文的 Brenton 英文文本相同。提供词级数据（仅表层形式，不含词元／Strong 编号／形态），供 get_interlinear 与希伯来语／阿拉姆语旧约及希腊语新约搭配使用	Open Greek and Latin Project / First1KGreek，经 github.com/nathans/lxx-swete	CC BY-SA 4.0
613,690 个原文词：希腊语新约 + 带有词元、Strong 编号、形态、释义和语义域的希伯来语／阿拉姆语旧约	MACULA (Clear-Bible/Biblica)	CC BY 4.0
Brown-Driver-Briggs 希伯来语与英语词典（1906 年，9,290 个词条）+ Strong 希伯来语词典（1890 年，修订版，8,674 个词条）——按 Strong 编号索引的完整学术词条（词源、义项划分、经文引文），包括 BDB 自有的带字母同形异义词（例如 H2617a「慈爱」与 H2617b「责备」——确实是不同的词，只是拼写相同）；在 word_study 中与现有简短释义一同显示	OpenScriptures HebrewLexicon	CC BY 4.0（标记；底层 BDB/Strong 文本属于公共领域）
Abbott-Smith《新约希腊语简明词典》（1922 年，517 个词条）——对新约希腊语词汇采用相同处理方式	First1KGreek / Open Greek and Latin Project，经 github.com/biblicalhumanities/Abbott-Smith	公共领域
约 345,000 条有排序的交叉引用	openbible.info	CC BY
约 4,800 名人物／地点／事件／群体 + 53,000 条经节链接	Theographic Bible Metadata	CC BY-SA 4.0
六部公共领域经典作品：《忏悔录》（奥古斯丁）、《效法基督》、《天路历程》、《操练神的同在》、《朱利安的启示录》、《正统》（切斯特顿）	Project Gutenberg	公共领域
《使徒教父文集》，共十部作品：1 和 2《克莱孟书信》、《巴拿巴书信》、《坡旅甲致腓立比人书》、《坡旅甲殉道记》、《伊格那丢书信》（较短编订本）、《伊格那丢殉道记》、《致丢格那妥书》、《黑马牧人书》、《帕皮亚残篇》	ANF (Roberts-Donaldson-Crombie), Project Gutenberg #77576	公共领域
爱任纽：《驳异端》，第 I–V 卷 + 残篇——806 个章节以 IREN-AH<book>.<chapter>.<section> 编址，因此标准引文（AH 3.3.4）可直接解析；1,598 条一级经文引文	ANF 第 I 卷 (Roberts-Rambaut)，Wikisource 转录文本	公共领域
殉道者游斯丁：《第一护教辞》《第二护教辞》《与特利弗对话》《游斯丁殉道记》——423 个章节，约 408 条一级引文	ANF 第 I 卷，Wikisource 转录文本	公共领域
一级引文图谱：从教父文献集（见 DESIGN.md §4）中译者自己的脚注提取的经文引文	—	—
Versemap：基于实证得出的 MT/NA ↔ 英文经节对齐数据，共 31 卷，988 条（约珥书 2–4 章、玛拉基书 3–4 章、何西阿书、以赛亚书 64 章、列王纪／历代志／尼希米记接缝处、约翰三书、使徒行传 19 章、启示录 12 章……），经释义验证；另含诗篇题注偏移量	基于语料库生成	—
研究成果层（layer='output'）：第 0 层语料库调查 + 第 2 层研究简报，主题包括 potter-and-clay、living water、wilderness——支持搜索和嵌入，并通过 draws_on 链接回其依据参考资料	在项目中生成	—
约 112,400 个嵌入向量（经节／窗口／段落），用于跨所有层的语义 + 混合搜索	bge-small-en-v1.5，本地生成	—
Easton《圣经辞典》（1897 年第 3 版，2,491 个词条）——作为完整语料文档，与上文的公共领域经典作品类似：可搜索（search(version="EASTON")）、可阅读（read_work("EASTON", ...)），并已生成嵌入向量，可用于语义搜索	Theographic 的结构化 JSON 再衍生版本	公共领域
旧约 + 新约概念图谱：5,673 个概念节点（神学主题 + 词汇关键词，基于 Easton《圣经辞典》生成种子），以及 171,000 多条带类型／关联的边（broader／narrower／causes／part_of／symbol_of／fulfills／associated），用于连接概念之间、概念与实体之间，以及两个约中的经节锚点；约 440 条带类型的边已根据引文证据进行人工审核（第 5／6 阶段），其余为机械生成的 associated 重叠计数。可通过 get_concept／concepts_in_passage／get_concept_relations 实时使用，见 DESIGN.md §5	基于语料库 + Easton《圣经辞典》生成	—
所有内容都存储在一个 SQLite 文件（db/bible.db，约 400 MB）中，并使用 FTS5 全文搜索。散文作品的寻址格式为 WORK.chapter.paragraph。架构设计依据请参阅 DESIGN.md。

工具

• get_passage(reference, version="BSB") — 获取指定经文的圣经文本，例如 John 3:16、John 3:16-18、Genesis 1。版本：BSB、WEB（次经需设置 version="WEB"）。
• search(query, version="BSB", book="", limit=20) — 全文搜索，支持词干提取并按相关性排序（BM25）。支持带引号的短语以及 AND/OR/NOT，例如 faith AND works NOT law。version 也可接受任意散文作品 ID。注意：词干提取会将相关词形合并（例如，“desert”也会匹配“deserted”）——可用引号括起精确短语，或添加 AND 条件词以消除歧义。
• semantic_search(query, top_k=12, kind="", hybrid=True) — 在整个语料库（经文 + 散文）中进行基于含义的搜索，默认与关键词搜索混合融合（RRF）。即使没有共同词语，也能找到主题相关的段落，例如 “divine self-emptying”。kind 为可选项：verse | window | paragraph。
• find_similar(reference, top_k=10) — 根据嵌入向量，在经文、次经和经典作品中查找与指定经文或散文段落最相近的段落。用于跨语料层查找平行内容。
• word_study(query, language="", limit=15) — 按 Strong 编号（可省略前导零）、词元（带或不带附加符号）、希伯来语/阿拉姆语转写（例如 miqweh，可省略长音符号）或英文释义进行原文词语研究。返回出现次数、释义范围、各书卷中的分布、可用时的完整学术词典条目（希伯来语为 BDB/Strong，希腊语为 Abbott-Smith——内容比释义更丰富，截断至约 700 个字符）以及示例经文。带字母后缀的同形异义词变体（例如 H4723 与 H4723a——拼写相同，词语不同）会一并显示。language 为可选项：grc | hbo | arc。
• get_interlinear(reference) — 获取指定经文或短范围的逐词原文：表层形式、词元、Strong 编号、释义、形态信息（希伯来语/阿拉姆语旧约，希腊语新约）。所有书卷均已进行经文映射校正，不仅限于《诗篇》。旧约经文还会显示可用的七十士译本希腊语表层文本（该来源不提供词元、Strong 编号或形态信息）。
• get_cross_references(reference, limit=20) — 获取某节经文的交叉引用（OpenBible.info，按社区投票排序），并附上目标经文文本。
• get_citations(reference, limit=20) — 获取教父文献中以名称引用某节经文的位置，信息提取自译者自己的脚注（第 1 级）。与 get_cross_references（经文→经文）互为补充；此处查询的是教父文本→经文。由于设计原因，覆盖范围有限——结果为空不代表该经文未被引用；要进行彻底查询，请在教父作品中使用全文 search。
• get_entity(name, entity_type="") — 按名称查询圣经人物、地点、事件或族群（Theographic 知识图谱）；返回详细信息及其出现位置。entity_type 为可选项：person | place | event | people_group。
• entities_in_passage(reference) — 获取与指定经文或章节关联的人物、地点和事件，例如 Genesis 14。
• get_concept(name, concept_type="") — 在旧约 + 新约概念图谱中查询神学概念或词汇关键词（基于 Easton's Bible Dictionary 构建）；返回定义、经文锚点、相关实体以及关系数量摘要。concept_type 为可选项：theme | keyword。也接受 Strong 编号。
• concepts_in_passage(reference) — 获取与指定经文或章节关联的神学概念和关键词，例如 Genesis 15。与 entities_in_passage 互为补充。
• get_concept_relations(name, verb="", limit=20) — 获取概念的类型化关系：broader/narrower/causes/part_of/symbol_of/fulfills/contrasts，并已根据引用证据进行人工审核。默认不包含数量多得多的机械生成 associated 关系——传入 verb="associated" 即可将其纳入。
• read_work(work, chapter=1, start=1, end=5) — 按段落范围阅读散文作品（CONFESSIONS、IMITATION、PILGRIM、PRESENCE、JULIAN、ORTHODOXY、1CLEMENT、BARNABAS、EASTON 等——完整列表请查看 corpus_info()）。请先使用 search(version=<WORK>) 查找段落。
• compare_versions(reference) — 并排比较 BSB 和 WEB 中的某节经文或短范围。
• corpus_info() — 查看语料库内容：文档、层级、许可证和数量。

提示词

服务器还会将综合流程作为 MCP 提示词公开，这些提示词由 .claude/skills/（事实来源）生成：corpus_survey(theme) — 第 0 层原始阅读规范；corpus_composer(theme) — 第 2 层研究简报撰写。任何安装了 bible-mcp 的 MCP 客户端都会随数据一并获得这套规范。

设置

pip install -r requirements.txt   # core: just `mcp`
pip install fastembed numpy       # optional semantic tier (semantic_search, find_similar)
python3 scripts/build_db.py       # rebuild db from data/sources (optional; db ships built)
python3 scripts/embed.py          # regenerate embeddings (optional; ships built; resumable)

首次执行语义查询时，会下载嵌入模型（约 65MB，仅需下载一次）。如果没有安装 fastembed/numpy，所有非语义工具仍可正常使用。有关架构决策（模型选择、分块、混合检索），请参阅 DESIGN.md。

Claude Desktop / Cowork — 添加到 MCP 配置中：

{
  "mcpServers": {
    "bible-mcp": {
      "command": "python3",
      "args": ["/path/to/bible-mcp/server.py"]
    }
  }
}

目录结构

data/sources/   raw acquired sources (immutable; re-derive, never edit)
data/versemap.tsv        derived MT/NA <-> English verse alignments
data/additions-*.json    prepared incremental ingestions (applied via scripts/ingest_additions.py)
scripts/        schema.sql, lib_refs.py, build_db.py, build_versemap.py, align_splits.py, ingest_additions.py
db/bible.db     the built corpus (SQLite + FTS5)
outputs/        synthesis-pipeline artifacts (Layer 0 surveys, Layer 2 briefs, reports)
.claude/skills/ corpus-survey + corpus-composer (pipeline skills; source for MCP prompts)
server.py       MCP server (FastMCP, read-only on the db)

公共版

这是一个非商业公共资源。许可分层适用 — 来源保留各自的许可（均为 PD / CC BY / CC BY-SA）；代码采用 PolyForm Noncommercial 1.0.0 许可；汇编内容和衍生数据（versemap、引用图、嵌入、输出层）采用 CC BY-NC 4.0 许可。完整详情见 LICENSE.md，署名信息见 NOTICE.md。

有三种使用方式：

1. 远程（无需安装） — 在任意 MCP 客户端中将托管端点添加为自定义连接器（Claude：Settings → Connectors → Add custom connector）： https://bible-mcp-server.fly.dev/mcp
2. 本地（stdio） — 克隆项目，从最新的 GitHub Release 下载 db/bible.db（或从 data/sources/ 重新构建），并添加上方的配置。
3. 自托管 — Dockerfile 提供 Streamable-HTTP 服务端；请参阅 DEPLOY.md。

设计说明

• 标准寻址：全程使用 OSIS 风格的引用（Gen.1.1）；每张表都以此为键。
• 来源信息：每条文档记录都包含来源、许可和许可等级（A=免费，B=相同方式共享，C=非商业，D=封闭 — 我们是非商业项目，因此可使用 C 类内容）。
• BSB 中“缺失”的 16 节经文（Matt 17:21、John 5:4、Acts 8:37…）是标准的批判文本删节，并非错误。
• 版本对齐：versemap（所有书卷）+ psalm_offsets（诗篇题注）用于将 MACULA 的 MT/NA 编号与英文编号对齐。两者均根据语料库自身的两份见证材料实证推导，并通过词义文本重叠进行验证；表结构与 TVTMS 兼容，因此之后可以用 STEPBible 数据扩展到其他传统文本（LXX、Vulgate）。
• Ignatius 仅包含较短的（中期）修订本；ANF 较长的修订本是后期扩充版，纳入后会导致搜索结果中每一章重复出现。
• 研究输出层由系统生成并有明确标记（layer='output'），不会与原始来源混淆；draws_on 链接用于将每项成果关联到其依据的引用。
• 根据 ROADMAP.md，下一步是：Irenaeus（获取来源）、第 2 级引用 shingles（将三个已确认的脚注索引遗漏作为测试用例）、完善 TVTMS。