Quran Search Engine Mcp

io.github.adelpro由 GitHub 帳號 adelpro 發布v0.2.1更新於 Oct 24, 2026

Quran Search Engine MCP for AI tools. Provides Quran search, Arabic normalization, and highlighting.

已驗證STDIO僅桌面網頁搜尋與抓取知識與記憶

概覽

AI 產生的概覽

讓助理搜尋與瀏覽古蘭經，回傳經過驗證的經文、章節中繼資料、詞元、詞根與詞形資訊，而非生成的內容。

可以做什麼
此 MCP 伺服器提供八個古蘭經查詢工具：全文檢索、章節中繼資料、經文定位、詞元與詞根查詢，以及詞形分析。每個請求都會導向以驗證資料集為基礎的專用搜尋引擎，而非由模型預測，因此回傳的是逐字經文。它也提供阿拉伯語正規化與比對結果標示。它可透過 stdio 在本機執行，也可作為託管的 Streamable HTTP 端點存取。
適用情境
當助理需要引用或查詢古蘭經經文、章節或阿拉伯語詞形，且準確性比自由生成更重要時使用。它適合研讀、查閱與阿拉伯語研究情境，這些情境中虛構經文是不可接受的。
執行需求
在本機執行需要 Node.js 20 或更新版本，以及 npm、pnpm 或 yarn，並以 npx 啟動此套件。託管的 HTTP 端點不需要 API 金鑰或驗證，只需網路存取。未宣告任何環境變數或標頭。
安裝前請注意
README 說明此公開端點開放、未經驗證並啟用 CORS，因此送往該端點的請求與查詢會離開使用者機器，並受依 IP 限流限制。本機 stdio 模式可避免這點。未描述任何憑證、付款或寫入操作。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Quran Search Engine Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Quran Search Engine MCP

[npm version] [MCP Registry] [smithery badge] [license] [Powered by quran-search-engine] [quran-search-engine]

An MCP (Model Context Protocol) server that gives AI clients fast, accurate, hallucination-free access to the Quran — search, navigation, and morphology — over stdio and Streamable HTTP.

Search, navigate, and explore the Quran through 8 MCP tools — verses, surahs, lemmas, roots, and morphology. Hosted at mcp.quran.us.kg. Instead of relying on an AI to "hallucinate" or predict Quranic verses, this tool routes every request to a dedicated search engine. The AI handles the natural language; the server returns the exact, literal Quranic text.

Public endpoint

The server is publicly hosted at https://mcp.quran.us.kg/ (Cloudflare-fronted, stable). No API key, no auth — the endpoint is open and CORS-enabled for any client.

ResourceURL
MCP server (Streamable HTTP)https://mcp.quran.us.kg/
Health checkhttps://mcp.quran.us.kg/health
Status pagehttps://quran.us.kg

Features

  • 🔌 MCP compatible — Claude Desktop, Claude Web, ChatGPT, Cursor, VS Code, and others.
  • 🌐 Two transports — stdio for local integrations, Streamable HTTP for remote/hosted.
  • 🔍 Eight tools — full-text search, surah metadata, verse navigation, lemma/root lookup, morphology.
  • 📖 Accurate results — every verse comes from a verified dataset; no LLM in the loop.
  • 🛡️ Hardened HTTP — host allow-list, per-IP rate limit, body cap, session reaper, /health.

Install

bash
# Use the public endpoint# → point your MCP client at https://mcp.quran.us.kg/
# Or run the server locally (stdio)npx -y quran-search-engine-mcp

Documentation

Detailed docs live under docs/:

  • Tools reference — every tool, its schema, response shape, and examples.
  • Integrations — Claude Desktop, Claude Web, ChatGPT, Cursor, and others.
  • Architecture — internals: transports, dataset loading, HTTP hardening.
  • Development — build, test, add a new tool, deploy.

Quick start (HTTP)

The shortest path: use any MCP client and point it at https://mcp.quran.us.kg/. For ad-hoc testing, the integrations page shows a one-off Node snippet that uses @modelcontextprotocol/sdk directly.

Quick start (Docker)

bash
docker compose up --build# → "Quran MCP HTTP server listening on http://0.0.0.0:4000/"

Requirements

  • Node.js 20+ (LTS recommended)
  • npm, pnpm, or yarn

License

MIT — see LICENSE.

Contact

Email: [email protected]

來源：README.md，提交 11c0a43

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分