About quran-search-engine-mcp
quran-search-engine-mcp is an MCP server for AI clients that need exact Quran text and related lookup. It uses a dedicated search engine and verified dataset rather than generating verses with an LLM.
Key features
- 01Full-text Quran search
- 02Surah and verse navigation
- 03Lemma and root lookup
- 04Morphology queries
- 05stdio and Streamable HTTP transports
Use cases
- 01Retrieve exact Quran verses for a question
- 02Navigate to a surah or verse
- 03Look up Arabic lemmas and roots
- 04Inspect word morphology
MCP support
Exposes eight MCP tools for Quran search, navigation, metadata, lemma and root lookup, and morphology. Clients can connect over stdio or Streamable HTTP, including the hosted endpoint.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
1Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | |
| root | boolean | No | |
| lemma | boolean | No | |
| limit | integer | No | |
| query | string | Yes |
Details
From the project READMEQuran Search Engine MCP
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]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.