Skip to content
Back to search

quran-mcp

An MCP server providing canonical Quran text, translations, and tafsir commentary — sourced from quran.com.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/quran/quran-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/quran/quran-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/quran--quran-mcp/badge.svg)](/listings/quran--quran-mcp)

HTML

<a href="/listings/quran--quran-mcp"><img src="/api/listings/quran--quran-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a remote MCP server (recommended)

Add to your MCP client configuration:

{
  "mcpServers": {
    "quran": {
      "url": "https://mcp.quran.ai",
      "type": "http"
    }
  }
}

Works with Claude Desktop, ChatGPT, and any MCP-compatible client.

Self-hosted

git clone https://github.com/quran/quran-mcp.git
cd quran-mcp
cp .env.example .env        # fill in database password
docker compose up -d         # starts postgres + server

The server runs at `http://localhost:8088`.

For integration patterns beyond basic hosting, see [docs/SETUP.md](docs/SETUP.md). It documents both MCP-server composition (for sibling servers such as `quran-mcp-auth`) and client-style consumption (for apps such as `quran-mcp-admin`).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 87 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # quran-mcp
  2. An MCP server providing canonical Quran text, translations, and tafsir commentary — sourced from [quran.com](https://quran.com).
  3. ## What this is
  4. quran-mcp is a [Model Context Protocol](https://modelcontextprotocol.io/) server that gives AI assistants grounded access to the Quran. Instead of relying on training data (which can misquote, fabricate, or confuse verses), the AI fetches verified text through structured tool calls.
  5. **Why this matters:** For Muslims, the Quran is the literal word of God. Misquoting it is not an acceptable error mode. This server exists so AI assistants can cite accurately, attribute properly, and defer to scholarly commentary rather than inventing interpretations.
  6. ## Capabilities
  7. - **Quran text** — Arabic text in multiple qira'at (Hafs, Warsh, Qaloon, etc.)
  8. - **Translations** — 50+ translations across 30+ languages
  9. - **Tafsir** — Classical and modern exegesis from 15+ scholars (Ibn Kathir, al-Tabari, al-Qurtubi, al-Sa'di, and more)
  10. - **Search** — Full-text search across Quran text, translations, and tafsir
  11. - **Morphology** — Word-level grammatical analysis, root concordance, paradigm tables
  12. - **Mushaf viewer** — Visual mushaf page rendering
  13. ## Quick start
  14. ### As a remote MCP server (recommended)
  15. Add to your MCP client configuration:
  16. ```json
  17. {
  18. "mcpServers": {
  19. "quran": {
  20. "url": "https://mcp.quran.ai",
  21. "type": "http"
  22. }
  23. }
  24. }
  25. ```
  26. Works with Claude Desktop, ChatGPT, and any MCP-compatible client.
  27. ### Self-hosted
  28. ```bash
  29. git clone https://github.com/quran/quran-mcp.git
  30. cd quran-mcp
  31. cp .env.example .env # fill in database password
  32. docker compose up -d # starts postgres + server
  33. ```
  34. The server runs at `http://localhost:8088`.
  35. For integration patterns beyond basic hosting, see [docs/SETUP.md](docs/SETUP.md). It documents both MCP-server composition (for sibling servers such as `quran-mcp-auth`) and client-style consumption (for apps such as `quran-mcp-admin`).
  36. ## Project structure
  37. ```
  38. src/quran_mcp/
  39. server.py Entry point
  40. mcp/ Client-facing MCP surface
  41. tools/ fetch_quran, search_tafsir, etc.
  42. resources/ MCP resources
  43. prompts/ MCP prompts
  44. lib/ Business logic and utilities
  45. middleware/ Request pipeline (rate limiting, grounding, logging)
  46. apps/ Frontend apps (documentation site, mushaf viewer)
  47. assets/ Static files
  48. tests/ Test suite
  49. codev/ Development methodology (specs, plans, protocols)
  50. ```
  51. ## Development
  52. ```bash
  53. uv venv && source .venv/bin/activate
  54. uv pip install -e ".[dev]"
  55. cp .env.example .env
  56. docker compose up -d
  57. pytest
  58. ```
  59. ## Data sources
  60. All Quran text, translations, and tafsir are sourced from [Quran Foundation](https://quran.foundation) projects, including [quran.com](https://quran.com) and [nuqayah.com](https://nuqayah.com).
  61. ## License
  62. [QFGPL-1.0](LICENSE.md) — Quran Foundation General Public License
  63. <img src=".assets/scorecard.png" width="100%">

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.