Quran Cloud MCP Server

🚀 Quran Cloud MCP Server

This is an MCP server that provides LLMs with access to the Quran API (https://alquran.cloud/api), aiming to reduce hallucinations regarding sensitive texts (such as the Quran).

🚀 Quick Start

Hallucination is a serious issue, especially when dealing with sensitive data where every character matters. Providing context can effectively reduce the risk of hallucinations. However, it's clearly inefficient to load the entire content of a large text file like the Quran in each request.

In this project, we've created an MCP server that connects LLMs to the free Quran Cloud API, enabling the models to fetch the required data on demand.

💻 Usage Examples

• Original Claude Response:
• Claude Response after Connecting to the New MCP Server:

📦 Installation

Make sure you have Python 3.13 and pip installed.

Clone the Repository

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

Navigate to the Project Directory

cd quran_cloud_mcp_server

Create a Virtual Environment

python -m venv .venv

Activate the Virtual Environment (Depending on the System)

• Windows:

.\venv\Scripts\activate

• Mac/Linux:

source .venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Create a .env File

OPENAI_API_KEY=Your-secret-key

Run the Server

python client.py

📚 Documentation

Connect the MCP Server to the Claude Desktop Application

1. Download and Install Claude: Claude Download Link

2. Configure Claude

   • Open Claude, go to the menu bar and select Settings.
   • Click Developer and then select Edit Configuration.

3. Modify the Configuration File

   • Open claude_desktop_config.json and add the following content:

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

• Replace YOUR_PROJECT_PATH with the actual path of your project.

4. Restart Claude to ensure the new configuration takes effect.

5. Verify the MCP Server Connection

   • Click the tool icon to check if the new MCP service has been successfully added.