Skillget

quran-search-engine-mcp

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Fail
  • network request — Outbound network request in docker-compose.yml
  • rimraf — Recursive directory removal in package.json
  • process.env — Environment variable access in scripts/check-submission.js
  • network request — Outbound network request in scripts/check-submission.js
  • process.env — Environment variable access in scripts/test-http.js
  • network request — Outbound network request in scripts/test-http.js
  • process.env — Environment variable access in scripts/test.js
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

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

README.md

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.

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

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: [email protected]

Reviews (0)

No results found