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 分