mcpserver.so LogoMCPFly
Submit
Quran MCP Server logo

Quran MCP Server

by djalal

Backend/ServersQuranAPIRESTOpenAPI

The Quran MCP Server provides an interface to interact with the Quran.com API using the Model Context Protocol. It allows LLMs to access and utilize Quranic data through a set of predefined endpoints.

View on GitHub

Last updated: N/A

What is Quran MCP Server?

This is a Model Context Protocol (MCP) server generated from the OpenAPI specification of the Quran.com REST API v4. It exposes various endpoints related to Quranic data, such as chapters, verses, translations, and tafsirs, as tools that LLMs can use.

How to use Quran MCP Server?

To use this server, you need to set it up either using Docker or Node.js. The README provides configuration examples for integrating it with Claude Desktop. You'll also need to configure environment variables like API_KEY and VERBOSE_MODE. Once configured, LLMs can interact with the server through its exposed endpoints.

Key features of Quran MCP Server

  • Exposes Quran.com API endpoints as tools.

  • Supports various endpoints for chapters, verses, juzs, search, translations, tafsirs, audio, and languages.

  • Integrates with Claude Desktop via MCP.

  • Offers Docker-based and Node.js-based deployment options.

  • Provides verbose logging for debugging API interactions.

Use cases of Quran MCP Server

  • Answering questions about the Quran using LLMs.

  • Retrieving specific verses or chapters based on user queries.

  • Searching the Quran for specific terms.

  • Providing translations and tafsirs of Quranic verses.

  • Integrating Quranic data into AI-powered applications.

FAQ from Quran MCP Server

What is an MCP server?

MCP stands for Model Context Protocol. It's a way for language models to interact with external tools and services.

Do I need an API key?

An API key might be required depending on the Quran.com API requirements. Check the API documentation for details.

How do I enable verbose logging?

Set the VERBOSE_MODE environment variable to 'true' to enable detailed logging of API requests and responses.

What are the system requirements?

The server requires Node.js 22+ and Docker for production deployment.

How do I run tests?

Run npm test to execute the test suite.