quran_cloud_mcp_server

@marwanWaly

About quran_cloud_mcp_server

MCP server to help LLMs to get access to Quran API (https://alquran.cloud/api).

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is quran_cloud_mcp_server?

A Model Context Protocol (MCP) server that connects large language models to the free Quran API (alquran.cloud) to retrieve accurate Quranic text and reduce hallucination. It is designed for developers working with sensitive Quran data where each character matters.

How to use quran_cloud_mcp_server?

Clone the repository, create a Python virtual environment, install dependencies from requirements.txt, create a .env file with your OPENAI_API_KEY, then run python client.py to chat with GPT‑4o in the terminal. To connect to Claude Desktop, edit claude_desktop_config.json by adding an MCP server entry pointing to server.py (host 127.0.0.1, port 8080) and restart Claude.

Key features of quran_cloud_mcp_server

Provides LLMs access to the Quran API to reduce hallucination
Retrieves only the needed Quran data efficiently
Connects to Claude Desktop via MCP configuration
Supports terminal chat with GPT‑4o via client.py
Uses the free Quran API (alquran.cloud)

Use cases of quran_cloud_mcp_server

LLM‑based Quranic research without text hallucination
Enhancing Claude desktop with accurate Quranic references
Building chatbots that answer questions about Quran verses
Integrating Quran data into AI applications via the API

FAQ from quran_cloud_mcp_server

What is the purpose of this MCP server?

It connects LLMs to the Quran API to prevent hallucination when dealing with Quran text.

How do I install and run the server?

Clone the repo, create a Python venv, install requirements, create a .env file with your OPENAI_API_KEY, then run python client.py.

How do I connect the server to Claude Desktop?

Edit the Claude Desktop config file (claude_desktop_config.json) to add an MCP server entry pointing to server.py with host 127.0.0.1 port 8080, then restart Claude.

What runtime dependencies are required?

Python 3.13, pip, and packages listed in requirements.txt. An OpenAI API key stored in .env is also required.

Does the server require any external API keys?

Yes, an OPENAI_API_KEY must be set in the .env file to communicate with GPT‑4o.

Frequently asked questions

What is the purpose of this MCP server?

It connects LLMs to the Quran API to prevent hallucination when dealing with Quran text.

How do I install and run the server?

Clone the repo, create a Python venv, install requirements, create a `.env` file with your `OPENAI_API_KEY`, then run `python client.py`.

How do I connect the server to Claude Desktop?

Edit the Claude Desktop config file (`claude_desktop_config.json`) to add an MCP server entry pointing to `server.py` with host `127.0.0.1` port `8080`, then restart Claude.

What runtime dependencies are required?

Python 3.13, pip, and packages listed in `requirements.txt`. An OpenAI API key stored in `.env` is also required.

Does the server require any external API keys?

Yes, an `OPENAI_API_KEY` must be set in the `.env` file to communicate with GPT‑4o.

Comments

Basic information

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K