MCP Markdown Bible Enricher

圣经丰富MCP服务器-NRSVCE（新修订标准版天主教版）

智能Markdown丰富圣经和教理问答参考

  ](https://nodejs.org/)   

特性 • 快速开始 • 安装 • 用法 • 配置 • API 参考

______________________________________________________________________

概述

圣经丰富MCP服务器 是一个 模型上下文协议 服务器，自动将Markdown文档中的纯文本圣经和教义问答引用转换为带有圣经网关URL的链接引用 黑曜石 维基链接。

天主教圣经资源： 此工具专为天主教圣经正典设计，支持所有 73本书 包括7本德国经典书籍：

• 托比特 -正义与家庭
• 朱迪思 -勇气和信念
• 智慧 -神圣智慧
• 锡拉赫 （传道书）-实践智慧
• 巴鲁克 -预言与安慰
• 1马加比 -犹太起义史
• 2马加比 -神学史

这7本书被收录在天主教圣经中，但没有收录在新教圣经中（新教圣经有66本书）。默认翻译（NRSVCE）包括所有次正典书籍。

非常适合：

• 天主教神学家和研究人员
• 天主教内容创作者
• 黑曜石 金库建造者
• 天主教圣经学习工作流程

它的作用

转换此内容：

Read CCC 528. Also see 1 Samuel 16:1, 16:4-13 and Matthew 2:6.

进入此：

______________________________________________________________________

特性

• 圣经门户链接 --每个圣经参考都变成了圣经门户的可点击链接（默认为NRSVCE翻译）
• 黑曜石 Wiki链接 --自动生成 [[Book-Ch#vN]] vault交叉引用格式
• CCC链接 --天主教教理问答参考文献与天主教交叉参考文献直接相关
• 确定性解析 --基于正则表达式的解析（不需要LLM）
• 模式识别 --识别复杂的模式，如 1 Samuel 16:1, 16:4-13 和 CCC 528-530, 610-612
• 安全 --不会修改现有链接或破坏Markdown结构
• 完整的天主教圣经 --支持所有73本书，包括7本次标准书籍
• 两种模式 --直接处理内存中的字符串或读/写文件

______________________________________________________________________

快速开始

# Clone the repository
git clone https://github.com/psenger/mcp-markdown-bible-enricher.git
cd mcp-markdown-bible-enricher

# Install dependencies
npm install

# Build the project
npm run build

# Test with MCP Inspector
npm run inspect

在Inspector中，尝试呼叫 bible_enrich_markdown 与：

Genesis 1:1 says "In the beginning..."

______________________________________________________________________

安装

先决条件

• Node.js>=18.0.0
• npm或纱线

地方发展设置

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

与AI工具集成

克劳德桌面版

1. 找到您的Claude Desktop配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 添加服务器配置：

基本配置（使用默认值）：

{
  "mcpServers": {
    "mcp-markdown-bible-enricher": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-markdown-bible-enricher/dist/index.js"]
    }
  }
}

使用自定义圣经版本和黑曜石格式：

{
  "mcpServers": {
    "mcp-markdown-bible-enricher": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-markdown-bible-enricher/dist/index.js"],
      "env": {
        "BIBLE_VERSION": "NRSVCE",
        "OBSIDIAN_FORMAT": "[[Bible/{abbrev}/{chapter}#v{verse}]]"
      }
    }
  }
}

1. 重新启动克劳德桌面

Claude 代码命令行工具

基础安装（项目范围）：

claude mcp add --transport stdio mcp-markdown-bible-enricher -- node /absolute/path/to/mcp-markdown-bible-enricher/dist/index.js

对于环境变量：

claude mcp add --transport stdio \
  --env BIBLE_VERSION=NRSVCE \
  --env OBSIDIAN_FORMAT="[[{abbrev}-{chapter2}#v{verse}]]" \
  mcp-markdown-bible-enricher -- node /absolute/path/to/mcp-markdown-bible-enricher/dist/index.js

作用域选项 (--scope 标志）：

• project （默认）--添加到 .mcp.json 在当前项目目录中
• user --添加到您的全局 ~/.claude.json （适用于所有项目）

# Install globally for all projects
claude mcp add --transport stdio --scope user mcp-markdown-bible-enricher -- node /absolute/path/to/mcp-markdown-bible-enricher/dist/index.js

验证安装：

claude mcp list

带MCP扩展的游标/VS代码

增添 .cursor/mcp.json:

{
  "mcp-markdown-bible-enricher": {
    "command": "node",
    "args": ["/absolute/path/to/mcp-markdown-bible-enricher/dist/index.js"]
  }
}

______________________________________________________________________

用法

快速示例

在克劳德桌面中：

Use the bible_enrich_markdown tool to process this text:
"According to Romans 8:28 and CCC 313, all things work together for good."

结果：

Deuterocanical书籍示例：

Use the bible_enrich_markdown tool to process this text:
"Read Tobit 12:8 and Wisdom 3:1-4 for guidance."

结果：

两种使用方法

选项1：过程文本（复制结果）

• 将标记粘贴到Claude对话中
• 使用 bible_enrich_markdown 工具
• 复制丰富的结果并粘贴到您的笔记中

选项2：流程文件（自动保存）

• 使用 bible_enrich_file 具有文件路径
• 文件被自动丰富和保存
• 可选择指定不同的输出路径以保持原始状态

Use bible_enrich_file with input_path: "/Users/me/Documents/bible-study.md"

支持的参考模式

______________________________________________________________________

配置

通过Claude Desktop配置中的环境变量自定义服务器：

环境变量

重要提示： 配置更改需要重新启动MCP服务器（完全退出并重新启动Claude Desktop）。

示例配置

不同的圣经版本：

{
  "mcpServers": {
    "mcp-markdown-bible-enricher": {
      "command": "node",
      "args": ["/path/to/mcp-markdown-bible-enricher/dist/index.js"],
      "env": {
        "BIBLE_VERSION": "NRSVCE"
      }
    }
  }
}

自定义黑曜石格式：

"env": {
  "OBSIDIAN_FORMAT": "[[Bible/{abbrev}/{chapter}#v{verse}]]"
}

圣经网关仅链接：

"env": {
  "BIBLE_VERSION": "ESV",
  "INCLUDE_OBSIDIAN_LINKS": "false"
}

______________________________________________________________________

API 参考

MCP工具

bible_enrich_markdown

用圣经和CCC链接丰富Markdown字符串。

参数：

• markdown （string，必填）——要丰富的Markdown文档

退货：

• string --丰富的Markdown内容

例子：

{
  "markdown": "Read Isaiah 40:31 and CCC 2095 about hope."
}

bible_enrich_file

读取Markdown文件，丰富它，并写入结果。

参数：

• input_path （string，必填）——输入Markdown文件的绝对路径
• output_path （string，可选）--输出文件的绝对路径（默认覆盖输入）

退货：

• string --带有输出路径的成功消息

例子：

{
  "input_path": "/Users/me/notes.md",
  "output_path": "/Users/me/notes-enriched.md"
}

MCP提示

bible_enrich_document

一个方便的提示，指示克劳德使用 bible_enrich_markdown 工具。

参数：

• markdown （string，必填）——要丰富的Markdown内容

help

显示所有可用工具、配置选项和使用示例的文档。

Claude Desktop中的用法：

Use the help prompt

或者简单地说：

help

这将显示：

• 可用工具及其参数
• 配置选项（圣经版本，黑曜石格式）
• 使用示例
• 获得更好结果的提示

______________________________________________________________________

支持的书籍

全部 天主教圣经73卷 支持：

重要提示： 要使用次正典书籍（托比特，朱迪思，智慧，西拉奇，巴鲁克，1-2马加比），你必须使用圣经门户上包含它们的翻译：

• 支持： NRSVCE （新修订标准版天主教版）- 默认 -包含全部73本书
• 支持： NABRE （新美国圣经修订版）-包括所有73本书
• 不支持： NCB （新天主教圣经）-圣经门户不包括次正典书籍
• 不支持：新教翻译（ESV、NIV、KJV等）-只有66本书

Old Testament (46 books)

新教教规（39本书）：

• 摩西五经：创世记、出埃及记、利未记、民数记、申命记
• 历史：约书亚、士师、路得、撒母耳记上1-2章、列王记下1-2篇、历代志下1-1章、以斯拉记、尼希米记、以斯帖记
• 智慧：约伯、诗篇、箴言、传道书、所罗门之歌
• 先知：以赛亚、耶利米、哀歌、以西结、但以理、何西阿、约珥、阿摩司、俄巴底亚、约拿、米迦、拿鸿、哈巴谷、西番雅、哈该、撒迦利亚、玛拉基

Deuterocanical书籍（7本书-仅限天主教）：

• 历史：托比特，朱迪思，1-2马加比
• 智慧：智慧，西拉奇（传道书）
• 预言家：巴鲁克

New Testament (27 books)

• 福音书：马太福音、马可福音、路加福音、约翰福音
• 历史：行为
• 保罗书信：罗马书、哥林多前书、加拉太书、以弗所书、腓立比书、歌罗西书、帖撒罗尼迦前书、提摩太书、提多书、腓利门书
• 一般书信：希伯来书、雅各书、彼得前书1-2、约翰福音1-2-3、犹大书
• 启示录：启示录

黑曜石缩略语

Complete list of all 73 book abbreviations

旧约（46卷）：

摩西五经：

• 创世记→ Gen
• 出埃及记→ Exod
• 利未记→ Lev
• 数字→ Num
• 申命记→ Deut

历史书籍：

• 约书亚→ Josh
• 士师记→ Judg
• Ruth → Ruth
• 1塞缪尔→ 1 Sam
• 2塞缪尔→ 2 Sam
• 1国王→ 1 Kings
• 2国王→ 2 Kings
• 1编年史→ 1 Chron
• 2编年史→ 2 Chron
• Ezra → Ezr
• 尼希米→ Neh
• 托比特→ Tob （次正典）
• 朱迪思→ Jdt （次正典）
• 以斯帖→ Esth
• 1马加比→ 1 Macc （次正典）
• 2马加比→ 2 Macc （次正典）

智慧书籍：

• Job → Job
• 诗篇→ Ps
• 箴言→ Prov
• 传道书→ Eccles
• 雅歌→ Song
• 智慧→ Wis （次正典）
• 西里奇→ Sir （deuterocaonical，也称为Ecclesiasticus）

先知书：

• 以赛亚→ Isa
• 耶利米→ Jer
• 哀歌→ Lam
• 巴鲁克→ Bar （次正典）
• 以西结书→ Ezek
• 丹尼尔→ Dan
• 何西阿→ Hos
• Joel → Joel
• Amos → Am
• 俄巴底亚→ Obad （单章）
• 约拿→ Jonah
• 迈卡→ Micah
• 那鸿→ Nah
• 哈巴谷→ Hab
• 西番雅→ Zeph
• 哈盖→ Hag
• 撒迦利亚→ Zech
• 玛拉基→ Mal

新约（27卷）：

福音书：

• 马修→ Matt
• Mark → Mark
• Luke → Luke
• John → John

历史：

• Acts → Acts

保罗书信：

• 罗马书→ Rom
• 哥林多前书→ 1 Cor
• 哥林多后书→ 2 Cor
• 加拉太书→ Gal
• 以弗所书→ Ephes
• 腓立比书→ Phil
• 歌罗西书→ Col
• 帖撒罗尼迦前书→ 1 Thess
• 帖撒罗尼迦后书2→ 2 Thess
• 提摩太前书→ 1 Tim
• 提摩太后书→ 2 Tim
• 提图斯→ Titus
• 腓利门→ Philem （单章）

一般书信：

• 希伯来人→ Heb
• 詹姆斯→ James
• 1彼得→ 1 Pet
• 2彼得→ 2 Pet
• 约翰一书→ 1 John
• 约翰二书→ 2 John （单章）
• 约翰三书→ 3 John （单章）
• Jude → Jude （单章）

启示录：

• 启示录→ Rev

笔记：

• 单章书籍（俄巴底亚、腓利门、约翰二书、约翰三书、犹大书）支持这两种形式：“犹大书1:9”和“犹大书9”
• 别名：所罗门之歌=雅歌，西拉奇=传道书=本·西拉智慧
• 上面标记的所有德语经典书籍

______________________________________________________________________

运作原理

建筑

浓缩过程使用 五次连续的正则表达式传递:

1. 反勾解封 --检测以下引用 ` 1 Samuel 16:1: ` 并在处理前删除回溯标记
2. 圣经参考检测 --匹配纯文本 chapter:verse 圣经参考（跳过现有的Markdown链接）
3. 单章裸诗 --匹配单章书籍中的裸诗引用（例如。， Jude 9, Obadiah 21)
4. 裸章参考 --仅匹配章节引用（例如。， Isaiah 53, Psalm 91)
5. CCC参考检测 --匹配教理问答段落编号

解析策略

graph LR
    A[Input Markdown] --> B[Unwrap Backticks]
    B --> C[Match chapter:verse Refs]
    C --> D[Match Single-Chapter Bare Verse]
    D --> E[Match Bare Chapter Refs]
    E --> F[Match CCC Refs]
    F --> G[Output Enriched]

主要特点：

• 反向向后/向前看可防止双重链接
• 处理隐式章节重复(16:1, 4-13 → 第16章两者）
• 解析诗歌范围(3-12)逗号分隔的列表(1, 4, 6)
• 单章书籍的特殊格式

圣经门户网址

格式： https://www.biblegateway.com/passage/?search={reference}&version=NRSVCE

• 默认翻译：新修订标准版天主教版（NRSVCE）
• NRSVCE包括所有73本天主教圣经书籍（包括次正典书籍）
• URL编码处理空格和特殊字符
• 可通过以下方式配置 BIBLE_VERSION 环境变量

黑曜石 Wiki链接

格式： [[Book-Ch#vN]]

• 例子： [[Matt-05#v3]] 马太福音5:3
• 单章书籍： [[Jude#v9]] Jude 9（链接中没有章节号）
• 裸露的章节： [[Isa-53]] 以赛亚书53章（无诗锚）
• 可通过以下方式配置 OBSIDIAN_FORMAT 环境变量

CCC链接

格式： https://www.catholiccrossreference.online/catechism/#!/search/{numbers}

• 支持范围： 528-530
• 支持列表： 528, 530, 532

______________________________________________________________________

黑曜石融合

此服务器旨在与 黑曜石 拱顶。《圣经》参考文献丰富了与《黑曜石》相匹配的维基链接 [[Note#heading]] 连接公约。

默认Wiki链接格式

自定义保险库结构

如果vault使用不同的文件命名约定，请设置 OBSIDIAN_FORMAT 匹配：

# Flat structure: "Gen 1:1" → [[Gen 1#v1]]
OBSIDIAN_FORMAT="[[{abbrev} {chapter}#v{verse}]]"

# Nested folders: "Gen 1:1" → [[Bible/Gen/01#v1]]
OBSIDIAN_FORMAT="[[Bible/{abbrev}/{chapter2}#v{verse}]]"

# Chapter-only files: "Gen 1:1" → [[Gen-01#verse-1]]
OBSIDIAN_FORMAT="[[{abbrev}-{chapter2}#verse-{verse}]]"

可用占位符：

• {abbrev} --书籍缩写（例如。， Gen, 1 Sam, Matt)
• {chapter} --章节号（例如。， 1, 16)
• {chapter2} --零填充章节号（例如。， 01, 16)
• {verse} --节数（例如。， 1, 28)

______________________________________________________________________

错误处理

无效的书籍名称

提及不存在的书籍（例如“摩尔门经1:1”） 保持不变。该工具只会丰富公认的圣经书名。

无效的章节/诗句引用

无效的章节或诗句编号（例如，“创世记999:999”） 已处理，但可能会产生损坏的圣经网关链接。圣经网关将显示无效引用的错误页面。

文件错误

• 文件未找到：返回错误消息： Error: ENOENT: no such file or directory
• 权限不足：返回错误消息： Error: EACCES: permission denied
• 编码无效：非-UTF-8文件可能会产生乱码输出或错误

工具错误

所有工具错误都会被捕获并返回 isError: true 旗帜。错误消息对用户友好，并指示问题。

______________________________________________________________________

局限性

文件大小

• 文件完全加载到内存中
• 建议限值：\10MB）可能会导致性能问题或内存错误

字符编码

• 必需：UTF-8编码
• 非-UTF-8文件将产生不正确的输出或错误
• 无自动编码检测

模式识别

• 使用正则表达式进行模式匹配
• 可能无法检测到非常复杂的嵌套结构
• 代码块内的引用（三重回溯）仍然丰富
• 内联代码中的引用（单个回溯）被解包和丰富
• CCC需要空间：使用“CCC 528”，而不是“CCC528”
• 单章书籍（俄巴底亚、腓利门、约翰二书、约翰三书、犹大书）支持这两本书 Jude 1:9 和 Jude 9 表格
• 裸露的章节引用，如 Isaiah 53 和 Psalm 91 支持无诗号

圣经入口限制

• 链接取决于圣经网关的URL结构
• 并非所有圣经翻译都可以在圣经门户网站上找到
• 次经：仅提供天主教翻译（NRSVCE、NABRE）
• NCB：尽管是“天主教徒”，但不包括次正典书籍

配置

• 配置已加载 一旦启动
• 更改环境变量需要 重新启动MCP服务器
• 不支持运行时配置更改

______________________________________________________________________

发展

项目结构

mcp-markdown-bible-enricher/
├── src/
│   ├── __tests__/       # tests
│   ├── config.ts        # Configuration for Bible Enrichment MCP Server
│   ├── index.ts         # MCP server entry point
│   ├── enrichment.ts    # Core regex logic
│   └── books.ts         # Bible book mappings
├── dist/                # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── CLAUDE.md           # Claude Code guidance
└── README.md

可用脚本

npm run build         # Compile TypeScript
npm run start         # Run the server
npm run dev           # Watch mode (auto-rebuild)
npm run inspect       # MCP Inspector GUI
npm run test          # Run tests
npm run test:watch    # Run tests in watch mode
npm run test:coverage # Run tests with coverage
npm run lint          # Lint with ESLint
npm run format        # Format with Prettier
npm run format:check  # Check formatting
npm run clean         # Remove dist/

测试

单元测试（Jest）：

npm test                 # Run all tests
npm run test:watch       # Watch mode
npm run test:coverage    # Coverage report

测试覆盖范围： 73天主教圣经书籍，配置，丰富模式，边缘案例

交互式测试（MCP检查员）：

npm run inspect

打开浏览器GUI：

• 具有自定义输入的测试工具
• 检查服务器功能
• 实时调试

TypeScript配置

• 模块系统：ES模块("type": "module")
• 导入扩展：使用 .js 即使文件是 .ts
• 目标：ES2022
• 严格模式：已启用

______________________________________________________________________

故障排除

常见问题

Server not appearing in Claude Desktop

1. 验证中的路径 claude_desktop_config.json 是绝对的
2. 确保构建成功： npm run build
3. 检查MCP日志（帮助→ Claude Desktop中的开发人员工具）
4. 重新启动克劳德桌面

References not being detected

• 确保书名拼写正确（不区分大小写）
• 检查章节中的拼写错误：韵文格式（必须 chapter:verse)
• 验证引用不在Markdown链接中 [text](url)
• 对于次正典书籍，请确保使用天主教翻译（NRSVCE或NABRE）
• 对模棱两可的情况使用回溯： ` John 3:16 `

Deuterocanonical books not working

如果提及托比特、朱迪思、智慧、西拉奇、巴鲁克或马加比不起作用：

1. 检查你的圣经版本：NCB不包括德语经典书籍

   "env": {
     "BIBLE_VERSION": "NRSVCE"
   }

1. 在圣经网关上验证翻译：访问圣经门户网站，用您选择的翻译手动搜索“托比特书1:1”

1. 支持德语经典书籍的翻译:

- 支持：NRSVCE（默认） - 支持：NABRE - 不支持：NCB、ESV、NIV、KJV（新教翻译）

File permission or encoding errors

# Check file permissions
ls -l /path/to/file.md

# Check file encoding
file -I /path/to/file.md

# Convert to UTF-8 if needed
iconv -f ISO-8859-1 -t UTF-8 input.md > output.md

Configuration changes not taking effect

配置已加载 一旦启动在Claude Desktop配置中更改环境变量后：

1. 保存配置文件
2. 完全退出 克劳德桌面（不仅仅是关闭窗口）
3. 重新启动克劳德桌面
4. 测试： Use the help prompt 验证配置

Build errors

# Clear node_modules and reinstall
rm -rf node_modules package-lock.json
npm install

# Clean and rebuild
npm run clean
npm run build

获取帮助

• 检查 API 参考
• 展开讨论
• 报告错误

______________________________________________________________________

许可证

该项目根据 GNU通用公共许可证v3.0.

看 许可证 文件以获取完整详细信息，或访问 https://www.gnu.org/licenses/gpl-3.0.html.

______________________________________________________________________

致谢

• 模型上下文协议 — Anthropic的MCP SDK
• 圣经门户 --经文和链接
• 天主教对照 --教理问答段落链接
• 黑曜石 社区 --维基链接格式的灵感(黑曜石社区插件)

______________________________________________________________________

支持

如果这个项目有助于你的工作：

• 为存储库添加星号
• 报告错误并建议功能
• 贡献代码或文档
• 与可能受益的人分享

______________________________________________________________________

专为天主教圣经学习和研究而建