MCPgee
MCPgee
MCPgeeMCPgee

Quran

v1.0.0•Knowledge & Memory•stable

📇 ☁️ MCP server to interact with Quran.com corpus via the official REST API v4.

quranmcpai-integration
Share:
66
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Quran?

Quran is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 ☁️ mcp server to interact with quran.com corpus via the official rest api v4.

📇 ☁️ MCP server to interact with Quran.com corpus via the official REST API v4.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 📇 ☁️ MCP server to interact with Quran.com corpus via the of

Use Cases

Query the Quran corpus via official REST API.
Search and retrieve Quranic verses naturally.
Analyze religious texts through AI integration.
djalal

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 15, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx quran

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Quran

The Quran MCP Server provides AI assistants with structured access to the full Quran.com corpus through the official Quran.com REST API v4. It exposes tools for retrieving chapters (surahs), verses by chapter or juz division, tafsir (exegetical commentary), translations in multiple languages, audio recitations, and full-text search across the Quranic text. Researchers, educators, and developers use it to build Islamic studies applications, answer questions about specific verses, or explore the Quran through conversational AI.

Prerequisites

  • Node.js 22 or later, or Docker installed
  • A Quran.com API key if required by the endpoint you are using (available from api.quran.com)
  • An MCP-compatible client such as Claude Desktop
  • Git to clone the repository (for Node.js deployment)
1

Clone the repository

Clone the quran-mcp-server repository to your local machine and enter the project directory.

git clone https://github.com/djalal/quran-mcp-server.git
cd quran-mcp-server
2

Install dependencies and build

Install the Node.js dependencies and compile the TypeScript source to the dist folder.

npm install
npm run build
3

Configure your MCP client

Add the Quran MCP server to your claude_desktop_config.json using the compiled Node.js entry point. Set API_KEY if Quran.com requires authentication for your usage level.

{
  "mcpServers": {
    "quran-api": {
      "command": "node",
      "args": ["/path/to/quran-mcp-server/dist/src/server.js"],
      "env": {
        "API_KEY": "your_api_key_if_needed",
        "VERBOSE_MODE": "false"
      }
    }
  }
}
4

Alternatively, deploy with Docker

Build and run the server as a Docker container. This avoids needing a local Node.js installation.

docker build -t quran-mcp-server .
# Then use Docker in your MCP config
5

Restart your MCP client

Restart Claude Desktop so it connects to the Quran MCP server. The tools for chapters, verses, search, tafsirs, and audio will become available.

Quran Examples

Client configuration

Claude Desktop configuration using the compiled Node.js server. Replace the path with the actual location where you cloned and built the repository.

{
  "mcpServers": {
    "quran-api": {
      "command": "node",
      "args": ["/path/to/quran-mcp-server/dist/src/server.js"],
      "env": {
        "API_KEY": "your_api_key_if_needed",
        "VERBOSE_MODE": "false"
      }
    }
  }
}

Prompts to try

These prompts demonstrate retrieval of verses, tafsir commentary, translations, and search across the Quranic corpus.

- "List all 114 surahs of the Quran with their English names."
- "Retrieve the first 7 verses of Surah Al-Fatiha (chapter 1)."
- "Search the Quran for verses mentioning 'patience' and show the first 5 results."
- "Get the Tafsir Ibn Kathir for verse 2:255 (Ayatul Kursi)."
- "Show me the available translations for Surah Al-Baqarah."
- "List the reciters available for audio recitation of the Quran."

Troubleshooting Quran

API returns 401 or 403 errors

Set the API_KEY environment variable in your MCP config to a valid key from api.quran.com. For public endpoints, the key may be optional, but private or high-rate endpoints require authentication.

Module not found or dist/ directory missing

Run 'npm install' followed by 'npm run build' in the project directory. The build step compiles TypeScript to JavaScript in the dist/ folder that the server.js entry point expects.

No results returned from search

Ensure the search query is in Arabic or an appropriate transliteration. The Quran.com API searches the original Arabic text and indexed translations. Enable VERBOSE_MODE=true in your config to log the raw API requests and responses for debugging.

Frequently Asked Questions about Quran

What is Quran?

Quran is a Model Context Protocol (MCP) server that 📇 ☁️ mcp server to interact with quran.com corpus via the official rest api v4. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Quran?

Follow the installation instructions on the Quran GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Quran?

Quran works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Quran free to use?

Yes, Quran is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Quran Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Quran? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "quran": { "command": "npx", "args": ["-y", "quran"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Quran?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides