Frequently Asked Questions about Kuran MCP Server

Q: What is the Kuran MCP Server? A: The Kuran MCP Server is a Model Context Protocol (MCP) server that provides access to Quranic data using the AlQuran.cloud API. It allows developers and researchers to programmatically retrieve and utilize Quranic text, translations, and metadata.

Q: What is the Model Context Protocol (MCP)? A: MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). In the context of the Kuran MCP Server, it defines a standardized way to access and interact with Quranic data.

Q: What is the AlQuran.cloud API? A: The AlQuran.cloud API is a comprehensive repository of Quranic data, including the original Arabic text, various translations, and metadata. The Kuran MCP Server uses this API as its data source.

Q: What features does the Kuran MCP Server offer? A: The Kuran MCP Server provides a variety of features, including:

• Listing all surahs (chapters) of the Quran.
• Managing and accessing Quran editions in different languages and translations.
• Retrieving specific verses by reference.
• Comparing multiple translations of the same verse.
• Searching for keywords within the Quran.
• Accessing specific juz’ (sections) of the Quran.
• Listing verses related to Sajda (prostration).
• Accessing the Quran by page number.
• Retrieving metadata about the structure of the Quran.

Q: How do I install the Kuran MCP Server? A: To install the Kuran MCP Server, you need to:

1. Clone the repository from the source code repository.
2. Install the required Python dependencies using pip install -r requirements.txt.
3. Run the server using python server.py.

Q: How do I use the Kuran MCP Server? A: The Kuran MCP Server provides a set of MCP tools that you can use to interact with the server. These tools include functions for listing editions, retrieving surahs and verses, searching the Quran, and more. Examples are provided in the documentation.

Q: What are the supported Quran editions? A: The Kuran MCP Server supports various Arabic, Turkish, and English editions of the Quran, including:

• Arabic: quran-uthmani, quran-simple
• Turkish: tr.diyanet, tr.vakfi
• English: en.asad, en.pickthall, en.sahih

Q: How can I test the Kuran MCP Server? A: The Kuran MCP Server includes a test.html file that you can open in a web browser to test all the API endpoints. This page provides a user-friendly interface for sending requests and viewing the results in real-time.

Q: How can I contribute to the Kuran MCP Server? A: You can contribute to the Kuran MCP Server by:

• Forking the repository.
• Creating a feature branch for your changes.
• Committing your changes with descriptive messages.
• Pushing your branch to your forked repository.
• Submitting a pull request.

Q: Where can I report issues or request new features? A: You can report issues or request new features by creating an issue on the GitHub repository.

Q: How does the Kuran MCP Server relate to UBOS? A: The Kuran MCP Server can be integrated with the UBOS (Full-stack AI Agent Development Platform) to create intelligent AI Agents that can understand and respond to questions about the Quran. UBOS provides a comprehensive environment for building, orchestrating, and deploying AI Agents.

Q: What license is the Kuran MCP Server released under? A: The Kuran MCP Server is released under the MIT License. See the LICENSE file for details.