Salaah MCP

by yusufk

Not rated
GitHub

About

FastAPI and MCP service providing Islamic prayer times and other useful calculations.

Details

Author
yusufk
Categories
Other, Community

Setup

Install Salaah MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/yusufk/salaah-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

Salaah MCP (Muslim Community Prayer Times)

A FastAPI and MCP service providing Islamic prayer times calculations using theislamic_timeslibrary.

This project relies on the following main dependencies:

- FastAPI: Web framework for building APIs
-
FastAPI MCP: Model Control Protocol
-
islamic_times: Core calculation engine for prayer times
- Pydantic: Data validation

git clone https://github.com/yourusername/salaah-mcp.git cd salaah-mcp

- Development:http://localhost:8000
- Production:
http://localhost:8000(configurable via UVV_PORT environment variable)

Calculate prayer times for a given location and date.

{ "latitude": -26.1528113, "longitude": 28.0049996, "method": "EGYPTIAN" }
{ "method": "Egyptian General Authority of Survey (Egypt)", "fajr": "2025-06-01T05:19:11.373053+02:00", "sunrise": "2025-06-01T06:47:44.369263+02:00", "zuhr": "2025-06-01T12:05:43.358460+02:00", "asr": "2025-06-01T15:23:52.560113+02:00", "sunset": "2025-06-01T17:23:52.560113+02:00", "maghrib": "2025-06-01T17:23:52.560113+02:00", "isha": "2025-06-01T18:43:09.341111+02:00", "midnight": "2025-06-02T00:06:02.228763+02:00" }

Get Qiblah direction and distance from any location.

{ "latitude": -26.1528113, "longitude": 28.0049996, "date": "2025-06-01T00:00:00Z" }
{ "distance_km": 5452, "distance_mi": 3388, "direction": "NNE", "angle_decimal": 14.647, "angle_dms": "014° 38′ 49.84″" }

Get detailed sun position and timing information.

{ "sunrise": "2025-06-01T06:47:40", "transit": "2025-06-01T12:05:33", "sunset": "2025-06-01T17:23:36", "apparent_altitude": -42.659, "apparent_azimuth": 276.796, "distance_au": 1.014106, "apparent_declination": 22.166, "apparent_right_ascension": "04h 39m 56.17s", "greenwich_hour_angle": 99.904, "local_hour_angle": 127.951 }

Get detailed moon position and phase information.

{ "moonrise": "2025-06-01T11:39:22", "transit": "2025-06-01T16:25:15", "moonset": "2025-06-01T22:54:19", "illumination": 36.38, "apparent_altitude": 25.803, "azimuth": 305.203, "distance_km": 388391, "parallax": 0.941, "topocentric_declination": 15.892, "topocentric_right_ascension": "09h 52m 04.77s", "greenwich_hour_angle": 21.198, "local_hour_angle": 49.245 }

Calculate new moon visibility using Yallop's criterion.

{ "latitude": -26.1528113, "longitude": 28.0049996, "date": "2025-05-27T00:00:00Z", "days": 3, "criterion": 1 }
[ { "criterion": "Yallop", "date": "2025-05-27T15:28:52", "value": -0.788, "description": "F: Not visible; below the Danjon limit." }, { "criterion": "Yallop", "date": "2025-05-28T15:56:44", "value": 0.958, "description": "A: Easily visible." } ]

- ISNA: Islamic Society of North America
- MWL: Muslim World League
- UMM_AL_QURA: Umm al-Qura University, Makkah
- EGYPTIAN: Egyptian General Authority of Survey
- KARACHI: University of Islamic Sciences, Karachi
- TEHRAN: Institute of Geophysics, University of Tehran
- JAFARI: Shia Ithna Ashari, Leva Research Institute, Qom

To use the prayer times service with Claude Desktop:

{ "mcpServers": { "Salaah Times": { "command": "/Users/yusuf/.local/bin/mcp-proxy", "env": { "SSE_URL": "http://localhost:8000/mcp" } } } }

-

Save this asclaude_desktop_config.jsonin your Claude Desktop configuration directory.
- Start Claude Desktop and you can now ask questions about prayer times like:

- "What time is Asr prayer today?"
- "When is Fajr tomorrow in Johannesburg?"
- "Show me all prayer times for London"

The AI will use the MCP service to calculate accurate prayer times based on your queries.

PiAPI MCP server makes user able to generate media content with Midjourney/Flux/Kling/Hunyuan/Udio/Trellis directly from Claude or any other MCP-compatible apps.

Multimodal MCP server for generating images, audio, and text with no authentication required

Read and write access to Airtable databases.

A Model Context Protocol (MCP) server that enables AI assistants to integrate with Prometheus Alertmanager

A comprehensive MCP server for tooling interactions(40+) and resource accessibility(60+) plus many useful prompts to interact with Algorand Blockchain.

An MCP server that provides control over Android devices through ADB. Offers device screenshot capture, UI layout analysis, package management, and ADB command execution capabilities.

AniList MCP server for accessing AniList API data

AnkiConnect MCP server for interacting with Anki via AnkiConnect.

Chat with any other OpenAI SDK Compatible Chat Completions API, like Perplexity, Groq, xAI and more

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.