Alfanous - Quranic Search Engine

Search and explore the Holy Qur'an with Arabic text, transliteration, and advanced search support.

io.github.Alfanous-team/alfanous · Repository · version 1.9.4 · 287 stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

uvx alfanous3-mcp

Results by platform

Linux

MCP handshake failed2026-08-16 · probed over pypi

2 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Traceback (most recent call last):
  File "/home/runner/.cache/uv/archive-v0/5bTK2qfpPkHk1vE2/bin/alfanous-mcp", line 6, in <module>
    from alfanous_mcp.mcp_server import main
  File "/home/runner/.cache/uv/archive-v0/5bTK2qfpPkHk1vE2/lib/python3.13/site-packages/alfanous_mcp/mcp_server.py", line 25, in <module>
    from mcp.server.fastmcp import FastMCP
ModuleNotFoundError: No module named 'mcp.server.fastmcp'

macOS

MCP handshake failed2026-08-16 · probed over pypi

2 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Traceback (most recent call last):
  File "/Users/runner/.cache/uv/archive-v0/W3tQg2USebOFegzK/bin/alfanous-mcp", line 6, in <module>
    from alfanous_mcp.mcp_server import main
  File "/Users/runner/.cache/uv/archive-v0/W3tQg2USebOFegzK/lib/python3.14/site-packages/alfanous_mcp/mcp_server.py", line 25, in <module>
    from mcp.server.fastmcp import FastMCP
ModuleNotFoundError: No module named 'mcp.server.fastmcp'

Windows

MCP handshake failed2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\CbXq8ApYy7ABU3OR\Scripts\alfanous-mcp.exe\__main__.py", line 4, in <module>
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\CbXq8ApYy7ABU3OR\Lib\site-packages\alfanous_mcp\mcp_server.py", line 25, in <module>
    from mcp.server.fastmcp import FastMCP
ModuleNotFoundError: No module named 'mcp.server.fastmcp'

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.alfanous-team__alfanous.json)](https://doesitinstall.com/s/io.github.alfanous-team__alfanous.html)