MCP.so
Sign In

quran_cloud_mcp_server

@marwanWaly

Repository

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

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

marwanWaly

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.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

ICSS

chokcoco

不止于 CSS

20.7K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

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