Skip to main content
Glama
adelpro

quran-search-engine-mcp

by adelpro
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Quran Search Engine MCP

npm version MCP Registry 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.

Resource

URL

MCP server (Streamable HTTP)

https://mcp.quran.us.kg/

Health check

https://mcp.quran.us.kg/health

Status page

https://quran.us.kg

Related MCP server: Quran Cloud MCP Server

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

# 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)

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: contact@adelpro.us.kg

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessSlow

Resources

Related MCP Connectors

Related MCP Servers

  • Quran MCP Server

    Prince77-7
    A
    license
    A
    quality
    D
    maintenance
    Provides AI assistants with comprehensive access to Islamic resources including Quran verses with translations, Tafsir commentary, Hadith collections, and audio recitations. Enables users to explore Islamic texts, get daily inspiration, and access scholarly interpretations through natural language queries.
    18
    9 npm
    10
    MIT

  • Quran Cloud MCP Server

    galihfr09
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects LLMs to the Quran API (alquran.cloud) to retrieve accurate Quranic text on-demand, reducing hallucinations when working with sensitive religious content.
    MIT

  • Quranpedia MCP

    adelpro
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides AI clients with fast, hallucination-free access to the Quran through 13 MCP tools, covering search, navigation, morphology, tafsir, translations, and surah background over stdio and Streamable HTTP.
    MIT