quran-search-engine-mcp

🚀 古兰经搜索引擎MCP

quran-search-engine-mcp 旨在弥合人工智能与真实古兰经文本之间的差距。它不依赖人工智能“臆想”或预测古兰经经文，而是将搜索请求路由到专门且准确的搜索引擎。人工智能负责处理自然语言理解，而MCP服务器则提供精确的古兰经文本，确保人工智能仅处理查询，经文始终准确无误。

🚀 快速开始

克劳德桌面版配置

选项1：快速启动（推荐给普通用户）

你可以直接使用已发布的软件包，无需自行构建。

1. 编辑配置文件：
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
2. 添加服务器条目：

{
  "mcpServers": {
    "quran-search-engine-mcp": {
      "command": "npx",
      "args": ["quran-search-engine-mcp"]
    }
  }
}

3. 重启克劳德桌面版。

选项2：本地开发（适用于贡献者）

1. 构建服务器：

pnpm build

2. 编辑配置文件：%APPDATA%\Claude\claude_desktop_config.json
3. 添加服务器条目：

{
  "mcpServers": {
    "quran-search-engine-mcp": {
      "command": "node",
      "args": ["D:\\path\\to\\quran-search-engine-mcp\\dist\\server.js"]
    }
  }
}

注意：请将 D:\\path\\to\\... 替换为你项目的实际绝对路径。 4. 重启克劳德桌面版。

配置完成后，你可以在聊天中使用它，例如输入：“Search the Quran for الحمد and show the results.”，任何与古兰经相关的查询都会直接发送到服务器，服务器将返回正确的经文。

✨ 主要特性

• 🔌 兼容MCP：可与克劳德桌面版及其他MCP客户端无缝协作。
• 🔍 高级搜索：支持阿拉伯语规范化、词元及基于词根的搜索。
• 📖 结果准确：返回精确经文，无臆造内容。
• 📄 分页功能：通过分页处理大量搜索结果。
• ✨ 高亮显示：清晰标记匹配的词条。

💻 使用示例

基础用法

例如，搜索先知尤努斯相关内容时，输入：

"Search for the Prophet Yunus with all synonyms"

结果将包含与 尤努斯、尤努斯的民众 甚至 祖努恩（即与鲸鱼相关的那位）相关的经文。

即使将搜索范围限制为仅搜索名称，结果依然精准，这证明人工智能能够理解查询意图，而数据源自可靠来源。

📦 安装指南

安装依赖

pnpm install

构建项目

pnpm build

本地开发

pnpm dev

测试项目

pnpm test

代码检查

pnpm lint

发布项目

pnpm build
pnpm version patch
pnpm publish --access public

📚 详细文档

本服务器基于 quran-search-engine 软件包构建核心搜索逻辑、阿拉伯语规范化、词元/词根匹配及高亮显示功能。详情请见 https://www.npmjs.com/package/quran-search-engine。

🔧 技术细节

quran-search-engine-mcp 能将任何兼容MCP的人工智能转变为可靠的古兰经搜索源。所有查询都通过服务器处理，经文始终准确，人工智能仅负责处理查询。这为教育应用、智能助手或任何需要无臆造内容且真实可信的古兰经搜索项目打开了大门。

📄 许可证

本项目采用MIT许可证。

贡献代码

详情请见 CONTRIBUTING.md。

联系我们

邮箱：contact@adelpro.us.kg