ahmedeltaher

azan mcp

Built by ahmedeltaher 382 stars

What is azan mcp?

Azan + Prayer Time + MCP + AI Agents + Islamic + Salah + A lightweight MCP library to calculate prayer times and trigger Azan with a single tool call. If you’re building an AI agent or prayer application, there’s no need to deal with astronomical calculations, timezones, or edge cases again.

How to use azan mcp?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add azan mcp using the following command: npx @modelcontextprotocol/azan-mcp 4. Restart the client and verify the new tools are active.
🛡️ Scoped (Restricted)
npx @modelcontextprotocol/azan-mcp --scope restricted
🔓 Unrestricted Access
npx @modelcontextprotocol/azan-mcp

Key Features

Native MCP Protocol Support
Real-time Tool Activation & Execution
Verified High-performance Implementation
Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities
Automating system workflows via natural language
Connecting external data sources to LLM context windows

azan mcp FAQ

Q

Is azan mcp safe?

Yes, azan mcp follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Q

Is azan mcp up to date?

azan mcp is currently active in the registry with 382 stars on GitHub, indicating its reliability and community support.

Q

Are there any limits for azan mcp?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub

AZAN

Android Arsenal Android ArsenalLICENSE Build Kotlin

What is Azan ?
The Muslim call to ritual prayer made by a muezzin from the minaret of a mosque (or now often played from a recording) . Muslims have 5 prayers per day, at each time all muslims are notified by Azan, to pray. first Muslims used to calcualte prayer time with sun raise and sun shadows, but to simplyied it and make it moreaccurent speacilly in cloudy cities, Mosques currently use a complex calcualtion based on latitude, longitude, height, timezone, sun raise time.

What is Azan library?

Library aiming to calculate prayer time with one line code , if you implement prayer time application , there is no need to do this headache again .

azan-preview

Islam Time prayers is every complex to calculate, cause there is many variables in this calculations like:

  • latitude
  • longitude
  • timezone
  • height
  • The Way of Calculation

Azan library enables you to determin latitude, longitude, timezone, height, The Way of Calculation as Inputes.

Supported Calculation Methods :

Method NameFajr AngelIsha Angel
Umm al-Qura University, Makkah18.590 min after Maghrib , 120 min during Ramadan
MUHAMMADIYAH2018
Muslim World League (MWL)1817
Egyptian General Authority of Survey19.517.5
University of Islamic Sciences, Karachi1818
Islamic Society of North America (ISNA)1515
Ithna Ashari1614
Institute of Geophysics, University of Tehran17.714
UOIF (Union des organisations islamiques de France)1212
Kuwait Calc method1817.5

How to use ?

Add it to dependencies in your gradle file

  • Add it in your root build.gradle at the end of repositories:

    • in your allprojects section , you have to add maven { url 'https://jitpack.io' }
allprojects {  
 repositories { 
                      maven { 
                                url 'https://jitpack.io' 
  	                      }
  	         }
  	       }
  • in your build.gradle of your app module , Add the dependency

    implementation 'com.github.ahmedeltaher:Azan:3.0'

Example how to get prayer times

val today = SimpleDate(GregorianCalendar())
val location = Location(30.045411, 31.236735, 2.0, 0)
val azan = Azan(location, Method.EGYPT_SURVEY)
val prayerTimes = azan.getPrayerTimes(today)
val imsaak = azan.getImsaak(today) 
println("----------------results------------------------") 
println("date ---> " + today.day + " / " + today.month + " / " + today.year)
println("imsaak ---> $imsaak") println("Fajr ---> " + prayerTimes.fajr()) 
println("sunrise --->" + prayerTimes.shuruq())
println("Zuhr --->" + prayerTimes.thuhr())
println("Asr --->" + prayerTimes.assr()) 
println("Maghrib --->" + prayerTimes.maghrib())
println("ISHA  --->" + prayerTimes.ishaa())
println("----------------------------------------") 

LICENSE

Ahmed Eltaher 2016

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Global Ranking

-
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "azan-mcp": { "command": "npx", "args": ["azan-mcp"] } } }