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）