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
