Quran Search Engine Mcp

io.github.adelproPublished by GitHub account adelprov0.2.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

MCP server that lets an assistant search and navigate the Quran, returning exact verified verses, surah metadata, lemmas, roots and morphology.

What you can do
  • Search the Quran full-text with Arabic normalization and highlighting
  • Look up surah metadata and navigate between verses
  • Look up lemmas and roots and inspect morphology
  • Return literal verse text from a verified dataset instead of model-generated text
When to use it
Useful when an assistant needs to quote or reference Quranic verses accurately and avoid hallucinated text, for study, research or content work involving surahs, verses, roots or Arabic morphology.
Requirements
Runs locally over stdio via the npm package (Node.js 20+ with npm, pnpm or yarn), or can be used through the provider's public Streamable HTTP endpoint. No API key or authentication is declared.
Before you install
The README states the hosted endpoint is open with no auth and CORS enabled, so requests and queries go to a third-party server; prefer the local stdio package if you do not want queries leaving your machine. The README also mentions per-IP rate limits on the hosted service.

Installation

In SourceWeft

  1. Open Quran Search Engine Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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]

Source: README.md at commit 11c0a43

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts