Bible by Midvash

Bible MCP

🌐 English · Português (BR) · Español

由 Midvash 提供的免费、无需密钥的 Model Context Protocol 服务。通过 ChatGPT、Claude、Gemini、Cursor 和任何其他 MCP 客户端，阅读、搜索和研读经文，涵盖 69 种语言的 117 个免费圣经版本（公有领域或采用开放许可，与 api.midvash.com 使用的目录相同）。服务部署在 Cloudflare 边缘网络上，并为 mcp.midvash.com 提供支持。

• 无需 API 密钥、无需身份验证、无需注册。 只需将客户端指向此 URL。
• HTTP Streamable 传输（通过 POST 进行无状态 JSON-RPC 通信）。
• 基于 Cloudflare Workers + R2 构建，使用与 api.midvash.com 相同的内容。
• 所有目录语言均支持搜索，包括不带元音符号输入的希伯来语和阿拉伯语。
• 采用 CC BY-SA 等许可的版本，会在每段文本末尾附上署名信息。

连接客户端

在 mcp.midvash.com 生成个人连接 URL，并将其添加到 MCP 客户端。URL 格式如下：

https://mcp.midvash.com/mcp/{id}?v=bsb,kjv&lang=en

• v：要提供的版本标识符，以逗号分隔（可选；省略则提供所有版本）。第一个版本是此连接的默认版本；如果没有设置 v，默认使用 BSB（英文）。
• lang：要提供的语言，以逗号分隔（可选；省略则提供所有语言）。

claude.ai / ChatGPT： 将 URL 添加为自定义连接器（Claude：Customize › Connectors；ChatGPT：开启开发者模式后，进入 Settings › Apps）。Gemini CLI： gemini mcp add --transport http midvash "<url>"。

示例（Cursor 和其他编辑器，mcp.json）：

{
  "mcpServers": {
    "bible": {
      "url": "https://mcp.midvash.com/mcp/{id}?v=bsb,kjv&lang=en"
    }
  }
}

ChatGPT 插件

ChatGPT 插件就是 MCP 服务，因此此服务本身就是插件。在 OpenAI 插件门户注册的端点为：

https://mcp.midvash.com/mcp/chatgpt

get_passage、get_verse 和 get_chapter 会指向一个交互式视图（ui://midvash/passage-v1.html，符合 MCP Apps 标准），显示带编号的经文，并提供一个按钮，可在 midvash.com 阅读该段经文。不支持 UI 的宿主仍会收到 Markdown。提交信息见 docs/chatgpt-plugin.md。

工具

工具	描述
get_verse	获取单节经文或一段经文。
get_chapter	获取完整章节。
get_passage	根据自由格式的引用获取经文（例如“John 3:16-18”）——这是引用经文最自然的方式。
search_bible	在《圣经》文本中搜索单词或完整短语，并基于 FTS5 索引按相关性（BM25）排序。搜索时忽略大小写、重音符号以及希伯来语／阿拉伯语元音符号；还可按书卷或约进行筛选。
compare_passage	比较同一段经文在多个《圣经》版本中的内容。
list_versions	列出可用的《圣经》版本／译本。
list_books	列出 66 卷书，可按约筛选。
search_study	搜索研究资料库，内容包括章节注释、《圣经》人物、词典条目和神学文章，支持 9 种语言。
get_commentary	获取引用所指章节的注释。涵盖 9 种语言的全部 1,189 个章节。
get_cross_references	查找与某节经文相关的其他经文，并按链接被广泛引用的程度排序。共 343,546 条链接。
get_strongs	按编号（“H430”）或词语本身查询 Strong 词典中的词条。共 14,197 条词条，释义支持 9 种语言。

研究工具会返回最多 500 个字符的摘要，以及指向 midvash.com 上完整文章的链接。 除了工具外，服务还提供 Resources——bible://{version}/{book}/{chapter} 可直接访问文本；另外还有四种研究 Prompts：讲道准备、灵修、词语研究和译本比较。书卷和版本参数支持自动补全。

返回数据的工具还会在 Markdown 内容旁一并返回 structuredContent， 这样客户端无需解析格式化文本。

限制

该服务为公开服务，无需身份验证，因此每个请求都会计入配额：

限制	数值
每个 IP 的工具调用次数	每分钟 60 次
JSON-RPC 批次大小	5 条消息
工具调用总量	每个 Cloudflare 位置每分钟 1,200 次

每个 tools/call 计为一个单位，因此批处理无法提高每个 IP 的上限。工具响应是确定且公开的，因此会在边缘缓存 24 小时——重复调用不计费，且响应速度快得多。

当前目录

MCP 当前公开的版本目录由 src/data/versions.ts 编译生成：共 117 个版本，均属公有领域或采用开放许可，覆盖 69 种语言代码：ar、as、bn、ceb、ckb、cs、da、de、ee、en、eo、es、fa、fi、fr、gr（希腊语）、gu、ha、haw、he、hi、hil、hne、ht、hu、id、ig、ilo、it、ja、ki、kn、ko、la、lg、mg、ln、luo、ml、mr、my、nb、nd、ne、nl、ny、om、or、pa、pl、pt-br、ro、ru、sn、sr、sv、sw、ta、te、tl、to、tr、tw、ug、uk、ur、vi、yo、zh。许可要求署名的版本（CC BY-SA 等）会附带一行 copyright，显示在工具返回的每段文本末尾。

公共 URL 可针对每个连接缩小该目录的范围：

https://mcp.midvash.com/mcp/{id}?v=bsb,kjv&lang=en

数据来源

存储	内容
R2 存储桶 bible	章节文本，路径为 {version}/{book}/{chapter}.json，在边缘缓存
D1 midvash-mcp-search	FTS5 索引：目录中每个版本的文本以及 18,792 篇研究文档

该 D1 数据库仅供此 MCP 使用。它是一个副本，由 scripts/seed-mcp-search.sh 重新构建，Worker 只会从中读取数据。将其单独存放意味着 Cloudflare 仪表板会独立报告此服务的用量；而 D1 绑定授予的是整个数据库的访问权限，单独存放则确保它只能访问公开的《圣经》内容。

目录中的每个版本都会分别进行搜索排序。希伯来语和阿拉伯语索引不包含元音符号，因此即使输入的词不带元音符号，也能匹配。

基准

Bible MCP 领域有三种实用模式：

服务	优势	Midvash 应借鉴之处
tuxr/bible-mcp	支持远程查询、搜索、导航、多种译本和次经。	添加一流的 Bible 搜索功能和更丰富的导航辅助工具。
molpass/mcp-bible	多版本查询、关键词／语义搜索、交叉引用、词语研究、原文词典数据。	添加语义／关键词搜索、交叉引用和可选的研读功能层。
djayatillake/studybible-mcp	词典、形态分析、交叉引用、上下文注释、更深入的研读工作流。	默认保持 Midvash 简洁，但在数据可用时提供高级研读工具。
ytssamuel/FHL-MCP-Server	丰富的中文 Bible 研读资源、注释书、原文分析、次经、专题研读。	将不同语言社群视为核心受众，而不只是译本筛选条件。

Midvash 的优势在于简单：远程使用、无需密钥、无需账户、通过 Cloudflare 快速交付，并围绕阅读器、API、应用、插件和数据构建开放生态。接下来的改进应保留这种低门槛体验，同时加入用户对 Bible 专用 MCP 服务所期待的发现和研读工具。

路线图

• 扩展 MCP 工具目录，使其覆盖更广泛的 Midvash 数据／API 功能。
• 改进 compare_passage，为较长段落提供更丰富的格式。
• 在有可靠开源数据可用时，添加面向研读的原文、词典和形态分析工具。

开发

npm install
npm run dev        # wrangler dev (local)
npm run typecheck  # tsc --noEmit

部署

通过 GitHub Actions（.github/workflows/deploy.yml）部署到 Cloudflare Worker midvash-mcp（自定义域名 mcp.midvash.com）——每次推送到 main 都会自动进行类型检查并部署。需要配置仓库密钥 CLOUDFLARE_API_TOKEN 和 CLOUDFLARE_ACCOUNT_ID。手动部署：

npm run deploy     # npx wrangler deploy

许可证

MIT © Midvash

Midvash 生态

这是 Midvash：Bible 与灵修 的一部分，这是一个免费的 Bible 阅读和研读平台。所有内容均为开放资源，彼此相互关联：

📖 阅读器（Web）	midvash.com — 支持 9 种语言
📱 iOS 和 Android 应用	App Store · Google Play
🔌 API	api.midvash.com · bible-api
🤖 MCP 服务	mcp.midvash.com · bible-mcp
🧩 WordPress 插件	midvash.com/wordpress-plugin · bible-wordpress-plugin
🧩 EmDash 插件	midvash.com/emdash-plugin · emdash-plugin-bible
🌐 Chrome 扩展程序	midvash.com/chrome-extension · bible-chrome-extension
📦 开放数据	bible-data · bible-data-js · bible-cross-references

_{免费且开放，由 Midvash 构建 · midvash.com}