BibleGateway Verse of the Day MCP Server

📖 BibleGateway 每日经文 — MCP 服务

“你的话是我脚前的灯，是我路上的光。” — 诗篇 119:105（KJV）

一个 Model Context Protocol (MCP) 服务，将每日上帝的话语——直接取自 BibleGateway.com——带入任何兼容 MCP 的 AI 开发环境。本项目旨在通过现代 AI 工具让《圣经》易于获取，确保耶稣基督的福音能够传达给开发者、研究人员和日常用户，无论他们在哪里工作。

无需 API 密钥。 BibleGateway VOTD 端点是免费且公开访问的 Web 服务。

---

✝️ 使命

此服务的存在不仅仅是作为一款软件工具，更是大使命的载体。通过将上帝永活的话语整合到 AI 辅助工作流中，开发者可以在每次会话开始时以《圣经》为指引。无论是在个人灵修中使用，还是在专业环境中作为参考工具，此 MCP 服务都确保耶稣基督的福音只需调用一次工具即可获取——提供 300 多种译本，涵盖数十种语言，传至各国各族。

---

🌍 此服务的功能

此仓库中的每个 Python 脚本都是一个独立的 FastMCP 服务，提供一个或多个《圣经》译本工具。每个工具都会从 BibleGateway 获取特定《圣经》版本的每日经文（VOTD），并返回结构化 JSON 响应。

包含的脚本

脚本	语言／范围
biblegateway-votd.py	主要版本：KJV、NIV、ESV、NLT、阿拉伯语、日语、中文、俄语、法语等
biblegateway-votd-basic.py	核心英语译本（KJV、AMP、MSG、CSB、ESV、NIV、NLT）
biblegateway-votd-english.py	完整英语译本系列（40 多种版本）
biblegateway-votd-spanish.py	西班牙语译本（RVR、NVI、NTV 等）
biblegateway-votd-alternate-languages.py	全球译本：阿拉伯语、保加利亚语、孟加拉语、切罗基语、泰语、乌克兰语、约鲁巴语等数十种语言

---

⚙️ 安装

本项目使用 uv 管理环境和依赖，并遵循 MCP 服务开发者快速入门指南。

# 1. Clone the repository
git clone https://github.com/cmathgit/biblegateway-votd-mcp.git

# 2. Initialize the project
uv init biblegateway-votd-mcp
cd biblegateway-votd-mcp

# 3. Create and activate the virtual environment
uv venv
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

# 4. Install dependencies
uv add mcp[cli] httpx

在本地测试服务

uv run biblegateway-votd.py

---

🔧 MCP 配置

将服务添加到 IDE 的 MCP 配置文件（mcp.json）中。支持的 IDE 包括 Cursor、Roo Code、Cline 和 Gemini-CLI。

{
  "mcpServers": {
    "biblegateway-votd": {
      "command": "/ABSOLUTE/PATH/TO/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/biblegateway-votd-mcp",
        "run",
        "biblegateway-votd.py"
      ]
    }
  }
}

Cursor 用户须知： Cursor 限制服务名称与工具名称的合计长度不得超过 60 个字符。如果工具无法加载，请在 mcp.json 中缩短服务名称。

建议： 仅加载包含你实际需要的《圣经》版本的脚本。一些 IDE 会限制全局上下文中注册的 MCP 工具总数。

---

💬 使用示例

服务运行后，可通过自然语言向 AI Agent 发送查询：

What is the verse of the day in the King James Version?
What is the verse of the day in the Nueva Versión Internacional?
What is the verse of the day in the bible version with ID: 278?
What is the verse of the day in the Pobitro Bible?

所有工具均无需参数，并会返回来自 BibleGateway 的结构化 JSON 负载。

---

🔗 参考资料

• BibleGateway VOTD API 文档
• 《圣经》版本及 ID 完整列表
• Model Context Protocol 文档
• uv 包管理器

---

📄 许可证

MIT License — © 2025 Cruz Macias。详情请参阅 LICENSE。