Quran MCP Server 🕌 - Revolutionary Islamic AI Assistant

A revolutionary Model Context Protocol (MCP) server that gives AI assistants powerful access to Islamic resources. The first MCP server with intelligent keyword search for Quran and Hadith - no more needing exact verse numbers!

✨ What Makes This Revolutionary?

🔍 Intelligent Search (NEW!)

• Search Quran by Keywords: Find verses about “patience”, “prayer”, “mercy” without knowing verse numbers
• Search Hadith by Topics: Discover hadiths about “charity”, “fasting”, “manners” instantly
• Topic-Based Discovery: AI understands common Islamic topics and finds relevant content
• Natural Language Queries: Ask “find verses about patience” and get instant results

📖 Comprehensive Quran Access

• Arabic Text: Original Quranic text in Arabic
• Multiple Translations: English translations from renowned scholars (Asad, Sahih International, Pickthall, Yusuf Ali, Hilali & Khan)
• Full Surah Retrieval: Get complete chapters with or without translations
• Random Verse: Daily inspiration feature
• Verse-by-Verse Access: Traditional reference-based lookup

📚 Tafsir (Commentary)

• Multiple Sources: Access to various Tafsir collections
  • Tafsir Ibn Kathir (English & Arabic)
  • Maarif-ul-Quran
  • Tafsir al-Tabari (Arabic)
  • Tafsir al-Qurtubi (Arabic)
• Verse-by-verse Explanations: Detailed scholarly commentary

📜 Hadith Collections

• Six Major Collections:
  • Sahih Bukhari (7,563 hadiths)
  • Sahih Muslim (7,563 hadiths)
  • Sunan Abu Dawud (5,274 hadiths)
  • Jami’ at-Tirmidhi (3,956 hadiths)
  • Sunan an-Nasa’i (5,758 hadiths)
  • Sunan Ibn Majah (4,341 hadiths)
• Random Hadith: Daily hadith feature

🎵 Audio Recitations

• Multiple Reciters: Choose from renowned Quran reciters
  • Maher Al-Muaiqly
  • Abdul Basit
  • Abdurrahman As-Sudais
  • Mishary Rashid Alafasy
  • Mahmoud Khalil Al-Hussary
• High-Quality Audio: MP3 format in various bitrates
• Playlist Generation: M3U playlists for full Surahs

⚡ Performance Features

• Intelligent Caching: LRU cache with TTL to minimize API calls
• Error Handling: Comprehensive error handling with meaningful messages
• Type Safety: Full TypeScript implementation with strict mode
• Validation: Input validation for all parameters

🚀 Installation - Just Copy & Paste!

Step 1: Add to Your AI Agent

Claude Desktop - Add this to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quran": {
      "command": "npx",
      "args": ["@quranmcp/server"]
    }
  }
}