What is Quran Cloud Mcp Server

quran_cloud_mcp_server is an MCP server designed to facilitate access to the Quran API (https://alquran.cloud/api) for Large Language Models (LLMs). It aims to reduce hallucination issues when processing sensitive Quranic text by providing relevant data on demand.

Use cases

Use cases include enhancing chatbots that provide Quranic information, developing educational applications for Quran studies, and integrating with AI models to ensure accurate responses based on Quranic texts.

How to use

To use quran_cloud_mcp_server, clone the repository from GitHub, create a virtual environment, install the required Python packages, set up your OpenAI API key in a .env file, and run the client script in your terminal to interact with the LLM.

Key features

Key features include direct access to the Quran API, reduced hallucination by providing context-specific data, and compatibility with various LLMs, such as Claude. The server allows for efficient retrieval of Quranic text without overwhelming the model with large text chunks.

Where to use

quran_cloud_mcp_server can be used in fields such as natural language processing, AI-driven chatbots, educational tools, and any application requiring accurate retrieval of Quranic text for analysis or interaction.

quran_cloud_mcp_server

MCP server to help LLMs to get access to Quran API (https://alquran.cloud/api) to prevent the hallucination with Quran text.

hallucination is a big problem specially when you are working on sensitive data that each character is important.

one way of reducing the hallucination is by providing the context to your LLM but of course with large chunk of text like the holy Quran it’s not efficient if you put all text in each request.

So, in this repo I have created an MCP server that’s connect your LLM to a free API https://alquran.cloud/api that enables your model to retrieve only the data he needs.

Also, I will show to you how we can connect this MCP server to Claude desktop application.

Example of Claude the original response

Example of Claude the new response after connecting to Search-Quran MCP server

Installation

make sure you have python 3.13 & pip

Open your terminal and write these commands

Cloning

git clone https://github.com/marwanWaly/quran_cloud_mcp_server.git

Move to project directory

cd quran_cloud_mcp_server

Create virtual environment

python -m venv .venv

Activate venv

On Windows

.\venv\Scripts\activate

On Mac or linux

source .venv/bin/activate

Python packages installation

Use the package manager pip to install requirements.txt.

pip install -r requirements.txt

Create .env file

OPENAI_API_KEY=Your-secret-key

Run in terminal

python client.py

now you can directly chat with GPT4o in your terminal

Connect the server to Claude Desktop

Download Claude desktop and open it

Step 1

Select setting from the file menu

Step 2

Click on Developer then Edit Config

Step 3

Open claude_desktop_config.json

Step 4

Write this configuration in the file

{
  "mcpServers": {
    "Search-Quran": {
      "command": "python",
      "args": [
        "PROJECT_PATH_ON_YOUR_PC\\server.py"
      ],
      "host": "127.0.0.1",
      "port": 8080,
      "timeout": 30000
    }
  }
}

Don’t forget to replace PROJECT_PATH_ON_YOUR_PC with the absolute path to your project server

Step 5

Restart Claude app (make sure it’s completely closed from your taskbar by right click on Claude icon and select Quit)

Check if the new MCP has been added

Click on tools icon