shamela-mcp — OpenClaw 适配版

在 المكتبة الشاملة 4 中搜索与研究 — 一个 MCP 插件，可将助手连接到本地库中的 8589 本书 和 3187 位作者，只读且无中间服务器。

• 版本： 1.3.0 — 34 个工具，用于搜索、阅读和引用

• 兼容性： OpenClaw（适配版）+ 任何 MCP 客户端

📌 本仓库： 为 OpenClaw 修改的版本，并包含 WSL2 构建修复。 原始仓库： alhoqbani/shamela-mcp — 功劳全归原作者。我们基于其源代码，并添加兼容层。

✨ 功能

• 在数千本书的文本中搜索（正文 + 脚注 + 注释），支持词形搜索和变体

• 范围筛选：书籍、作者、分类、回历时期

• 阅读完整的页面、章节和目录

• 古兰经（搜索 + 按拼写体/奥斯曼体显示的经文）+ 关联经注

• 圣训出处考证，并通过 الشاملة 的索引关联到其来源

• 生成可随时发布的、以 الشاملة 风格格式化的引用

• 新工具：verify_quote（验证引用文本）、scan_consensus（扫描共识/分歧）、research_scope（覆盖各学派）、suggest_download（书籍推荐）

Related MCP server: principia-mcp

🚀 OpenClaw 快速安装

git clone https://github.com/SMSMy/shamela-mcp.git
cd shamela-mcp
npm install && npm run build

openclaw mcp set shamela '{
  "command": "node",
  "args": ["'$(pwd)'/dist/index.js"],
  "env": {
    "SHAMELA_INSTALL_ROOT": "/mnt/d/shamela4",
    "SHAMELA_JRE": "/usr/bin/java"
  },
  "cwd": "'$(pwd)'"
}'

openclaw mcp reload

环境变量

⚠️ 前提条件：你的设备上装有 الشاملة 4，并且至少下载了一本书。

✅ 试试

在 المكتبة الشاملة 中搜索「الكلام」，并告诉我它出现在哪些书中、以及出自谁。

如果显示了书名、作者、页码和摘录 — 就说明可以正常使用。

🔧 构建说明（WSL2）

在 WSL2 下配合 Windows 的 javac.exe 时，构建脚本会自动将 classpath 转换为 Windows 路径：

SHAMELA_INSTALL_ROOT=/mnt/d/shamela4 npm run build

📦 许可协议

MIT — 查看 LICENSE. 该插件以只读方式访问 الشاملة 的数据，不修改任何内容。