Quran Cloud

Quran Cloud is an MCP server that connects large language models to the alquran.cloud API to retrieve exact Quranic verses and context. Large language models often hallucinate or misquote religious texts when generating Arabic Quranic verses or theological citations from memory, where even minor character changes alter textual meaning. By integrating this server into their AI workflows, researchers, religious scholars, developers, and everyday users can dynamically pull precise Quranic passages on demand without bloating prompt contexts with entire scriptures. The server retrieves targeted surahs, ayahs, or passages directly from the web API, supplying models with verified source text. This targeted retrieval allows LLMs to focus strictly on relevant data segments during text generation, ensuring high accuracy for theological studies, translation evaluations, cross-referencing tasks, and Islamic knowledge applications.

Category: Notes & Knowledge Management

Tags: quran, religion, text-retrieval, theology

Visit Quran Cloud

How to install and configure Quran Cloud

1. Clone the repository and navigate into the folder: bash git clone https://github.com/marwanWaly/quran_cloud_mcp_server.git cd quran_cloud_mcp_server 2. Create and activate a Python 3.13 virtual environment: bash python -m venv .venv source .venv/bin/activate (On Windows, run .\venv\Scripts\activate). 3. Install dependencies: bash pip install -r requirements.txt 4. Create a .env file containing your OpenAI key if running the client script: bash OPENAI_API_KEY=Your-secret-key 5. Open your claude_desktop_config.json file and add the configuration under mcpServers: json { "mcpServers": { "Search-Quran": { "command": "python", "args": [ "PROJECT_PATH_ON_YOUR_PC\\server.py" ], "host": "127.0.0.1", "port": 8080, "timeout": 30000 } } } Replace PROJECT_PATH_ON_YOUR_PC with the absolute path to your server.py file and restart Claude Desktop.

What you can do with Quran Cloud

• Fetching accurate Arabic Quranic text directly into Claude Desktop to prevent scriptural hallucinations during religious inquiries. - Retrieving specific verses and chapters on demand without needing to pass the entire Quran into prompt context windows. - Assisting researchers in cross-referencing Quranic ayahs against scholarly commentaries and translation analyses within an AI workspace. - Powering a terminal-based chat interface backed by GPT-4o to explore religious questions with verified primary source citations. - Verifying theological citations and text accuracy for educational tools and content generation systems.

Key facts

• https://github.com/galihfr09/quran_cloud_mcp_server
• Notes & Knowledge Management, Web Search & Research
• quran, religion, text-retrieval, theology

Part of MCP Servers

What is Quran Cloud?

Quran Cloud is a Model Context Protocol server that connects AI assistants like Claude Desktop or OpenAI models to the alquran.cloud API. It enables language models to retrieve verified Quranic verses dynamically, minimizing errors and hallucinations when discussing sacred texts.

How do I install Quran Cloud?

To install Quran Cloud, clone its GitHub repository, create a Python 3.13 virtual environment, and install the dependencies from requirements.txt. You can then configure your claude_desktop_config.json file to run the server script or test it via the included Python client.

Which MCP clients work with Quran Cloud?

Quran Cloud works with Claude Desktop by configuring the local command in claude_desktop_config.json. It can also be run locally using the provided terminal client script that interacts with OpenAI models.

What can Quran Cloud do?

The server queries the alquran.cloud API to retrieve exact text passages from the Holy Quran. Instead of injecting the full Quran into prompt memory, the server fetches only requested chapters and verses to answer queries accurately.