Alfanous - Quranic Search Engine MCP Server

Alfanous is a Quranic search engine API that provides simple and advanced search capabilities for the Holy Qur'an. It enables developers to build applications that search through Quranic text in Arabic, with support for Buckwalter transliteration, advanced query syntax, and rich metadata. It runs locally over stdio via the published package.

People connecting search tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-06-14 · ★ 287 · #9 OF 47 MAINTAINED SEARCH · VERIFIED 2026-08-25

LGPL-3.0 · Python servers · how we verify → /methodology

01 · Install Alfanous - Quranic Search Engine

Claude Code

claude mcp add alfanous-team-alfanous -- uvx alfanous3-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "alfanous-team-alfanous": {
      "command": "uvx",
      "args": [
        "alfanous3-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license LGPL-3.0 - declared in the repository

pypi package alfanous3-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.Alfanous-team is GitHub-verified and matches the repo owner

03 · What Alfanous - Quranic Search Engine can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.9.4 · 2026-06-14

Fix memory leak: bound shared Whoosh searcher idf/filter caches · Fix stale reader-retry contract test asserting fixed retry count · Fix memory leak: bound shared Whoosh searcher idf/filter caches · Fix stale…

v1.9.3 · 2026-06-13

Handle phrase-fallback correctly for nested Whoosh queries in search_obj · Fix UnpicklingError for query on As-Saaffat aya_id 57 · Fix ValueError unsupported pickle protocol when querying · Retry on EOFError during…

v1.9.2 · 2026-05-04

Fix query timeout caused by backtick in search queries

04 · Who maintains Alfanous - Quranic Search Engine

Alfanous - Quranic Search Engine is maintained by alfanous-team. It's the only MCP server we track from this author; the repo dates to Jun 2012.

05 · Facts

repository: github.com/alfanous-team/alfanous
category: search - ranked #9 of 47 actively-maintained search servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-06-14)
registry: io.github.Alfanous-team/alfanous (active, first published 2026-03-04 · 41 versions)
packages: pypi:alfanous3-mcp

06 · Alfanous - Quranic Search Engine FAQ

What is Alfanous - Quranic Search Engine?

Is Alfanous - Quranic Search Engine still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-14 and it shipped 2 releases in the last 90 days. We re-verify nightly.

How do I install Alfanous - Quranic Search Engine?

Run `uvx alfanous3-mcp`. You can also paste the ready-made client config above.

Does Alfanous - Quranic Search Engine run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Alfanous - Quranic Search Engine

Alternatives to Alfanous - Quranic Search Engine

Maintained search servers if Alfanous - Quranic Search Engine isn't the fit.

Pairs well with

Servers that cover what Alfanous - Quranic Search Engine doesn't - only shown when the pairing reason fits the companion.

More search MCP servers · Webgate · Webshift · Arjunkmrm Perplexity Search · AI Seo · Citation Intelligence

More Python MCP servers · Spotifyscraper · Densely · Mengram · Joplin MCP Server · Alphago2580 Naramarketmcp · see all