# Alfanous - Quranic Search Engine

Searches Quranic verses using Arabic text, Buckwalter transliteration, and linguistic filters. Useful when an assistant needs accurate script matching or verse analysis.

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

## What it does

This MCP server searches the text of the Holy Qur'an using Arabic script and Buckwalter transliteration. It accepts Boolean logic with `+`, `|`, and `-` operators, alongside wildcard patterns. You can group output by Sura or Juz and filter by verse attributes such as sajda markers.

Two search modes determine how queries match. Exact search targets fully vocalized text where diacritics are strictly significant. Fuzzy search activates the Snowball Arabic stemmer, drops common stop words, and matches typos using Levenshtein edit distance against unvocalized text.

Local execution relies on `uvx` running the `alfanous3-mcp` package. Exact matching is strict about diacritics: omitting tashkeel will fail against the vocalized `aya_` index.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add alfanous -- uvx alfanous3-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from alfanous3-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add alfanous-quranic-search-engine -- uvx alfanous3-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from alfanous3-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alfanous-quranic-search-engine": {
            "command": "uvx",
            "args": [
                "alfanous3-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from alfanous3-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alfanous-quranic-search-engine": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "alfanous3-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from alfanous3-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add alfanous-quranic-search-engine uvx alfanous3-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from alfanous3-mcp <command>

## When to use it
- search Quranic verses using Arabic phrases, wildcards, or Buckwalter transliteration
- filter verses by Sura, Juz, or specific attributes like sajda
- handle spelling variants and typos via Levenshtein distance matching
- retrieve verse metadata, translations, and recitation indices

## Example prompts
- Search for Quranic verses matching Buckwalter string 'Allh' with sura facets
- Find all verses containing 'الصلاة' and filter by surah Yasin
- Run a fuzzy search for verses with sajda using edit distance 1

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

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