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