Advertise
MCP.so
Sign In

Quran Cloud MCP Server

@marwanWaly

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

marwanWaly

About Quran Cloud MCP Server

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

#quran#llm#api#mcp-server

Quran Cloud MCP Server 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
    }
  }
}

Quran Cloud MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What is the purpose of this MCP server?

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

2

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`.

3

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.

4

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.

5

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

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Advertise