quran-mcp-server

quran-mcp-server

30
entertainment_and_mediaknowledge_and_memory

This project provides an MCP server that facilitates interaction with the Quran.com corpus through an official REST API. It supports multiple endpoints for accessing Quranic texts, translations, and other related resources, with integration options for Claude Desktop.

Overview

  • MCP server for interacting with the Quran.com corpus via REST API v4.
  • Generated from an OpenAPI specification.
  • Multiple endpoints available for accessing and searching Quranic chapters, verses, juzs, translations, tafsirs, audio, and languages.
  • Integrated with Claude Desktop with configurations for Docker and Node.js setups.
  • Requires Node.js 22+ and Docker.

Endpoints

  • Chapters: List chapters, get chapter info.
  • Verses: Get by chapter, page, juz, hizb, rub el hizb, or randomly.
  • Juzs: List all juzs.
  • Search: Query the Quran for specific terms.
  • Translations: Access available translations and their details.
  • Tafsirs: Access available tafsirs and their information.
  • Audio: List reciters and recitation styles.
  • Languages: Get all supported languages.

Setup

  • Requirements: Node.js 22+, Docker.
  • Includes Docker setup and configurations for Claude Desktop.

Environment Variables

  • API_KEY, PORT, VERBOSE_MODE (for debugging).

Verbose Mode

  • Detailed logging for requests, responses, and errors when enabled.

Testing

  • Tests can be run using npm test.

License

  • MIT License.