QuranKu 是 Printing Press 系列的 CLI 工具,通过 quranku-pp-cli 二进制提供《古兰经》相关功能,并附带同源 MCP 服务器供智能体调用。它把《古兰经》文本、Ustadz Muhammad Thalib 的印尼语 Tarjamah Tafsiriyah 译本,以及 Quran.com 的章节元数据与音频存于本地 SQLite,可在无网络搜索 API 时按词或含义查找经文。
用途与主要能力:surah 读取整章及 Tafsiriyah 译文,verse 精确查询单节(如 2:255),find 在本地阿拉伯文与印尼语译本索引中离线检索,daily 与 random 提供每日或随机一节用于反思,websearch 做在线全文检索。个人实践方面:plan 制定 N 天读完《古兰经》的计划并本地记录进度,hifz 标记与复习背诵进度,bookmark 保存带笔记的经文。此外提供 audio、chapters、juz、recitation、tafsirs、uthmani、verses 等元数据与音频命令。
使用方式:先安装 CLI,macOS/Linux 默认可执行文件位于 $HOME/.local/bin,Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin:npx -y @mvanhorn/printing-press-library install quranku --cli-only,并用 quranku-pp-cli --version 验证;若失败可改用 go install github.com/mvanhorn/printing-press-library/library/education/quranku/cmd/quranku-pp-cli@latest(需 Go 1.26.6 或更新)。任何命令可加 --agent(等价于 --json --compact --no-input --no-color --yes),支持 --select 裁剪字段、--dry-run 预览、--deliver 输出到 stdout/file:webhook,以及 profile 保存标志组合。路径可用 --home 或 QURANKU_HOME 等环境变量重定位。无需认证,可用 doctor 检查设置。
适用场景与限制:适合需要该特定译本、离线经文检索、精确按节查询或阅读与背诵追踪的智能体和用户。该工具为只读加本地个人状态,不适用于圣训、教法裁决等非《古兰经》文本,不提供礼拜时间或朝拜方向,也不用于创建、修改或发布上游内容。文档未说明收费或价格信息,本介绍不作推断。