Alfanous
Alfanous is an Arabic search engine API provides the simple and advanced search in Quran , more features and many interfaces...
What is Alfanous?
Alfanous is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to alfanous is an arabic search engine api provides the simple and advanced search in quran , more features and many interfaces...
Alfanous is an Arabic search engine API provides the simple and advanced search in Quran , more features and many interfaces...
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Alfanous is an Arabic search engine API provides the simple
Use Cases
Maintainer
Works with
Installation
PIP
pip install alfanous3-mcpManual Installation
pip install alfanous3-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Alfanous
Alfanous is an Arabic Quran search engine exposed as both a Python library and an MCP server, providing simple and advanced search across Quranic verses using Boolean operators, wildcards, phrase matching, root-level morphological search, and field-specific queries. The MCP server exposes dedicated tools for searching by themes, statistics, verse position, word linguistics, and query spell-correction, making it possible for AI assistants to perform precise Arabic text retrieval within the Quran. It is useful for Islamic studies, Arabic NLP research, and building applications that need structured access to Quranic content.
Prerequisites
- Python 3.x and pip
- uv or uvx for convenient package running (optional but recommended)
- An MCP client such as Claude Desktop
- Basic familiarity with Arabic text input for constructing search queries
Install the alfanous3-mcp package
Install the MCP server package from PyPI. The package name is alfanous3-mcp (the '3' indicates the Python 3 compatible version).
pip install alfanous3-mcpVerify the MCP server starts correctly
Test that the server launches without errors by running it directly. It should start and wait for MCP client connections.
python -m alfanous_mcp.mcp_serverConfigure your MCP client
Add the Alfanous MCP server to your Claude Desktop configuration file. The server is invoked as a Python module.
{
"mcpServers": {
"alfanous": {
"command": "python",
"args": ["-m", "alfanous_mcp.mcp_server"]
}
}
}Restart Claude Desktop
Quit and relaunch Claude Desktop to load the Alfanous server. The Quran index will be built or loaded on first start, which may take a few seconds.
Test with a basic Arabic search
Ask Claude to search the Quran for a term in Arabic. The server's search_quran tool will return matching verses with translation metadata.
Alfanous Examples
Client configuration
Claude Desktop configuration for the Alfanous Quran search MCP server.
{
"mcpServers": {
"alfanous": {
"command": "python",
"args": ["-m", "alfanous_mcp.mcp_server"]
}
}
}Prompts to try
Example prompts for searching and exploring Quranic content via the Alfanous MCP server.
- "Search the Quran for verses containing الله (Allah) and show the first 10 results."
- "Find all Quranic verses that mention both الصلاة (prayer) and الزكاة (almsgiving)."
- "Search for the phrase الحمد لله as an exact phrase match in the Quran."
- "Do a root-level search for the root ر ح م (mercy) and list matching verses."
- "Get information about Surah Al-Fatiha including the number of verses and themes."
- "Suggest query corrections for a misspelled Arabic search term."Troubleshooting Alfanous
ModuleNotFoundError: No module named 'alfanous_mcp'
Ensure the correct package is installed: 'pip install alfanous3-mcp' (not alfanous3 alone). If using a virtual environment, make sure it is activated. Verify installation with 'pip show alfanous3-mcp'.
First search is very slow or times out
Alfanous builds a Whoosh search index on first use. This index creation can take 10-30 seconds depending on your machine. Subsequent searches will be much faster as the index is cached. Do not interrupt the process on first run.
Arabic search returns no results or unexpected matches
Arabic text is sensitive to diacritics (tashkeel) and Unicode normalization. Try searching without diacritics first. For morphological search, use the root-level syntax ('>>>root') to find all grammatical forms. The correct_query tool can suggest alternate spellings if a search returns empty.
Frequently Asked Questions about Alfanous
What is Alfanous?
Alfanous is a Model Context Protocol (MCP) server that alfanous is an arabic search engine api provides the simple and advanced search in quran , more features and many interfaces... It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Alfanous?
Install via pip with: pip install alfanous3-mcp. Then configure your AI client to connect to this MCP server.
Which AI clients work with Alfanous?
Alfanous works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Alfanous free to use?
Yes, Alfanous is open source and available under the LGPL-3.0 license. You can use it freely in both personal and commercial projects.
Alfanous Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Alfanous? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Alfanous in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Alfanous?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.