MCP Server for Quran.com API
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
ordocker 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
API_KEY
: API key for authenticationPORT
: Server port (default: 8000 or 3000 depending on language)VERBOSE_MODE
: Set to 'true' to enable verbose logging of API requests and responses (default: false)
Verbose Mode
When VERBOSE_MODE
is set to 'true', the server will log detailed information about API requests and responses to the console. This is useful for debugging and monitoring API interactions.
The verbose logging includes:
- Requests: Logs the tool name and arguments for each incoming request
- Responses: Logs the tool name and result data for each response
- Errors: Logs detailed error information including error name, message, and stack trace when available
Each log entry is timestamped and prefixed with the log type (REQUEST, RESPONSE, or ERROR) for easy identification.
Testing
License
This project is licensed under the MIT License.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
MCP server to interact with Quran.com corpus via the official REST API v4.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides access to Jina AI's powerful web services (page reading, web search, fact checking) through Claude.Last updated -318912JavaScriptMIT License
- -securityAlicense-qualityAn MCP server that provides powerful search capabilities for Jewish texts and literature. This server enables Large Language Models to search and reference Jewish texts through a standardized interface.Last updated -12PythonMIT License
- AsecurityAlicenseAqualityA powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.Last updated -414612TypeScriptMIT License
RSS3 MCP Serverofficial
-securityAlicense-qualityAn MCP server implementation that integrates the RSS3 API, allowing users to query data from decentralized chains, social media platforms, and the RSS3 network through natural language.Last updated -1JavaScriptMIT License