djalal/quran-mcp-server

MCP server to interact with Quran.com corpus via the official REST API v4.
Overview
This is a Model Context Protocol (MCP) server generated from the OpenAPI specification.
Endpoints
The following endpoints from the API have been made available as tools, that LLMs can use via compatible clients.
Chapters
* GET /chapters - List Chapters
* GET /chapters/{id} - Get Chapter
* GET /chapters/{chapter_id}/info - Get Chapter Info
Verses
* GET /verses/by_chapter/{chapter_number} - Get verses by Chapter / Surah number
* GET /verses/by_page/{page_number} - Get all verses of a specific Madani Mushaf page
* GET /verses/by_juz/{juz_number} - Get verses by Juz number
* GET /verses/by_hizb/{hizb_number} - Get verses by Hizb number
* GET /verses/by_rub/{rub_el_hizb_number} - Get verses by Rub el Hizb number
* GET /verses/by_key/{verse_key} - Get verse by key
* GET /verses/random - Get a random verse
Juzs
* GET /juzs - Get list of all juzs
Search
* GET /search - Search the Quran for specific terms
Translations
* GET /resources/translations - Get list of available translations
* GET /resources/translations/{translation_id}/info - Get information of a specific translation
Tafsirs
* GET /resources/tafsirs - Get list of available tafsirs
* GET /resources/tafsirs/{tafsir_id}/info - Get the information of a specific tafsir
* GET /quran/tafsirs/{tafsir_id} - Get a single tafsir
Audio
* GET /resources/chapter_reciters - List of Chapter Reciters
* GET /resources/recitation_styles - Get the available recitation styles
Languages
* GET /resources/languages - Get all languages
Setup
Requirements
* Node.js 22+
* Docker
Building the Docker Image
Before using the Docker-based production mode, you need to build the Docker image:
Claude Desktop Integration
To use this MCP server with Claude Desktop, add the following configuration to your claude_desktop_config.json file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):
Docker-based Production Mode
Production Mode (Node.js)
Development Mode
**Important Notes:**
- Replace /path/to/quran-mcp-server with the actual path to this repository on your system
- You'll need to build the project first with npm run build or docker build -t quran-mcp-server . if using the production mode configuration
- Replace your_api_key_if_needed with an actual API key if required by the Quran.com API
- If you already have other MCP servers configured, add this configuration to the existing mcpServers object
- After updating the configuration, restart Claude Desktop for the changes to take effect
Environment Variables