djalal/quran-mcp-server
This MCP server acts as a bridge between AI language models and the Quran.com API, enabling structured programmatic access to the Quranic corpus. It exposes the API's endpoints—such as chapters, verses, recitations, translations, and tafsirs—as tools that LLMs can invoke directly. Built from the OpenAPI specification of the REST API v4, the server ensures comprehensive coverage of available resources. It supports various query methods: by chapter, page, juz, verse key, or even random selection, providing both text and audio links. The server is implemented in TypeScript and can be run using Node.js or containerized with Docker, making it easy to deploy in any environment. It follows the Model Context Protocol (MCP), which standardizes how external tools communicate with language model–powered applications. When integrated with MCP clients (like Claude Desktop or custom agents), the server allows users to ask natural language questions about the Quran and receive accurate, sourced responses. For example, an LLM can retrieve a specific verse, list chapters, or fetch multiple translations and interpretations on the fly. By leveraging the official Quran.com API, the server provides reliable and up-to-date data, ensuring that the content is aligned with the authoritative corpus. It can be used to build AI-powered applications for Islamic education, research, and content creation. Whether developing a chatbot, a study companion, or an auto‑translation tool, this MCP server simplifies the integration of Quranic knowledge into modern AI workflows.
- Category
- Developer Tools
- Pricing
- Open Source
Problem solved
Developers and researchers who want to incorporate Quranic text and metadata into AI applications face the challenge that language models lack direct access to this specialized corpus. This MCP server solves that by providing a standardized interface that LLMs can use to query verses, translations, and tafsirs from the Quran.com API, enabling accurate Islamic content retrieval without manual data scraping or API key management.
Use cases
- Building an AI chatbot that answers Quranic questions with verse references.
- Developing a multi‑language Quran study app with side‑by‑side translations and tafsir.
- Creating a Quranic search engine that returns relevant verses by keyword or theme.
- Integrating audio recitation playback in an e‑learning platform for memorization.
- Assisting researchers in performing corpus analysis on Quranic text and translations.
- Enabling content creators to quickly look up and cite verses in articles or videos.
Audience
- Developers
- ML Engineers
- Researchers
Pros
- Comprehensive endpoint coverage via OpenAPI generation.
- Easy setup with npm or Docker.
- Enables LLMs to access authoritative Quranic data.
- Supports various query types (verse key, juz, page, random).
- Open source and community‑maintained.
Cons
- Requires running an additional server process.
- Dependent on the availability of the Quran.com API.
- Limited to the API’s data; no offline access or local caching included.
Official website: https://github.com/djalal/quran-mcp-server
Canonical LambdaBase page: https://www.lambdabase.com/tools/djalal-quran-mcp-server