圣经数据访问服务

Kairos Codex-MCP服务器

该服务器实现了模型上下文协议（MCP），以提供对圣经数据资源的标准化访问。它充当大型语言模型（LLMs）的“工具提供者”，允许他们查询圣经翻译、书籍和经文。

服务器在中实现 bible.py 并在 https://bible.helloao.org，为圣经访问提供MCP工具，并提供全面的错误处理和身份验证支持。

核心功能

服务器提供以下MCP工具：

• get_翻译 -获取可用圣经翻译列表，并可选择语言过滤
• 获取_书籍 -获取特定圣经翻译中可用的书籍列表
• get_verse -从给定翻译中的一章中获取特定的诗句
• get_chapter -从给定翻译的书中获取整章内容

技术栈

• 语言： Python 3.11+
• MCP框架： FastMCP
• HTTP客户端： httpx
• 身份验证： 基于简单令牌的身份验证（可选）
• 数据格式： 具有结构化错误处理的JSON响应
• 集装箱化： 包括Docker支持

可用工具

get_translations（语言）

• 说明： 获取可用圣经翻译列表
• 参数：
  • language （str）：要筛选的语言（匹配语言、languageEnglishName或languageName）
• 退货： 翻译对象列表，包括id、name、englishName、language、numberOfBooks等。

get_books（translation_id）

• 说明： 获取特定圣经翻译中可用的书籍列表
• 参数：
  • translation_id （str）：用于获取书籍的翻译ID
• 退货： 带有翻译信息的对象和带有id、名称、通用名称、章节号等的书籍列表。

get_verses（translation_id，book，chapter，verse_start，verse_end？）

• 说明： 从章节中获取特定的诗句
• 参数：
  • translation_id （str）：要使用的翻译ID
  • book （str）：书籍名称、标签或ID
  • chapter （int）：章节号
  • verse_start （int）：起始诗号（含）
  • verse_end （int，可选）：结束诗号（含）
• 退货： 包含翻译信息、书籍信息和诗歌数据的结构化对象，以及元数据

get_chapter（translation_id，书籍，章节）

• 说明： 从一本书中获取整章内容
• 参数：
  • translation_id （str）：要使用的翻译ID
  • book （str）：书籍名称、标签或ID
  • chapter （int）：章节号
• 退货： 包含翻译信息、书籍信息和本章所有经文的结构化对象

入门指南

先决条件

• Python 3.11+
• 所需软件包： fastmcp, httpx, pydantic, PyYAML, python-dotenv

安装

安装依赖项：

pip install -r requirements.txt

配置

可选择设置访问控制的身份验证令牌。您可以通过两种方式做到这一点：

选项1：环境变量

export BIBLE_SERVER_TOKEN=your_token_here

选项2:.env文件（推荐）

创建一个 .env 项目根目录中的文件：

echo "BIBLE_SERVER_TOKEN=your_token_here" > .env

如果没有设置令牌，服务器将在没有身份验证的情况下运行。

运行服务器

直接执行Python：

python bible.py

使用Docker：

# Build and run with docker-compose
docker-compose up --build

# Or build and run manually
docker build -t kairos-codex-mcp .
docker run -p 8000:8000 kairos-codex-mcp

服务器在端口8000上使用流式HTTP传输运行，可以通过MCP客户端连接。

贡献

（稍后填写-投稿指南）

许可证

（待定，例如MIT、GPL）