# quran-search-engine-mcp

Connects verified Quranic records to AI agents using 8 search and morphology tools. Prevents model hallucinations by retrieving literal verse data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: adelpro
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/adelpro/quran-search-engine-mcp
- Updated: 2026-08-06
- HTML: https://affpapa.org/en/nevibecode/mcp/quran-search-engine-mcp

## What it does

This server connects an AI client directly to a verified Quran database. Instead of letting language models invent verses, requests pass to an engine that returns exact Quranic text. The bundle delivers 8 distinct tools covering verse navigation, full-text queries, surah metadata, and Arabic word morphology with root lookups.

Integration works over stdio for local environments and Streamable HTTP for remote instances. Anyone can query the public endpoint at `https://mcp.quran.us.kg/` without an API key or account token. Running the server locally via `npx` strictly requires Node.js 20 or newer. You can also spin up an instance with Docker using `docker compose up --build` on port 4000.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "quran-search-engine-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "quran-search-engine-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "quran-search-engine-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "quran-search-engine-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add quran-search-engine-mcp npx -y quran-search-engine-mcp
```

## When to use it
- locate Quranic verses by keywords or phrases
- analyze Arabic word roots and morphological parts
- pull verified surah metadata and verse text
- prevent AI hallucinations when quoting sacred scripture

## Example prompts
- Find verses addressing patience and return the Arabic text.
- Retrieve metadata for Surah Al-Baqarah along with its opening verses.
- Inspect the morphological breakdown of the opening word in Surah Al-Fatiha.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md