quran_cloud_mcp_server

By marwanWaly GitHub

MCP server to help LLMs to get access to Quran API (

quran llm

Overview

What is Quran Cloud MCP Server?

Quran Cloud MCP Server is a middleware server designed to help large language models (LLMs) access the Quran API efficiently, reducing the risk of hallucination when dealing with sensitive text.

How to use Quran Cloud MCP Server?

To use the Quran Cloud MCP Server, clone the repository, set up a virtual environment, install the required packages, and run the server. You can then connect it to the Claude desktop application for enhanced interaction with the Quran API.

Key features of Quran Cloud MCP Server?

Connects LLMs to the Quran API to retrieve specific data.
Reduces hallucination by providing context-sensitive access to Quranic text.
Easy integration with the Claude desktop application.

Use cases of Quran Cloud MCP Server?

Enabling LLMs to answer questions based on Quranic text accurately.
Assisting in research that requires precise references from the Quran.
Enhancing applications that utilize Quranic content for educational purposes.

FAQ from Quran Cloud MCP Server?

What is hallucination in LLMs?

Hallucination refers to the generation of incorrect or nonsensical information by language models, especially when handling sensitive data.

Is the Quran Cloud MCP Server free to use?

Yes! The server is open-source and free to use.

How do I connect the server to Claude?

Follow the provided steps in the documentation to configure Claude to use the MCP server.

Content

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

Claude original response

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

Claude New response

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

server running in terminal

Connect the server to Claude Desktop

Download Claude desktop and open it

Step 1

Select setting from the file menu

step 1

Step 2

Click on Developer then Edit Config

step 2

Step 3

Open claude_desktop_config.json

step 3

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 4