Malaysia Prayer Time MCP Server

by amanasmuei
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.


Descripción general

El servidor MCP de horarios de oración de Malasia proporciona horarios de oración islámicos precisos para ubicaciones en toda Malasia. Este servidor implementa el Protocolo de Contexto de Modelo (MCP) para integrarse a la perfección con Claude Desktop, ofreciendo horarios de oración en tiempo real directamente a través de su asistente de IA.

El servidor utiliza la API waktusolat.app para recuperar los horarios de oración verificados por JAKIM y admite la búsqueda por ciudad, código de zona o coordenadas.

Características

Horarios según la ubicación : obtenga horarios de oración para cualquier ciudad o distrito de Malasia
Soporte de coordenadas : encuentre horarios de oración usando coordenadas de latitud y longitud
Acceso al código de zona : consulte directamente utilizando los códigos de zona JAKIM (por ejemplo, SGR03 para Kuala Lumpur)
Horario de oración completo : recupera todos los horarios de oración diarios (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha)
Estado actual de oración : determina los horarios de oración actuales y próximos
Manejo robusto de errores : manejo elegante de problemas de red y cambios de API
Integración perfecta con Claude : Integración limpia con Claude Desktop a través de MCP

Instalación

Prerrequisitos

  • Python 3.10 o superior
  • Claude Desktop (última versión)
  • gestor de paquetes pip o uv

Opción 1: Instalación desde GitHub

# Clone the repository git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git cd mcp-server-malaysia-prayer-time # Create and activate a virtual environment python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies pip install -e .

Opción 2: Uso de rayos UV (recomendado)

# Clone the repository git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git cd mcp-server-malaysia-prayer-time # Create and activate a virtual environment using uv uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies uv pip install -e .

Configuración

Configurar Claude Desktop

  1. Cree o edite el archivo de configuración de Claude Desktop:

macOS :

mkdir -p ~/Library/Application\ Support/Claude/ nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Ventanas :

mkdir -p %APPDATA%\Claude notepad %APPDATA%\Claude\claude_desktop_config.json
  1. Agregue la siguiente configuración (ajuste las rutas según su configuración):
{ "mcpServers": { "malaysia-prayer-time": { "command": "/absolute/path/to/your/.venv/bin/python", "args": [ "main.py" ], "cwd": "/absolute/path/to/mcp-server-malaysia-prayer-time" } } }
  1. Reiniciar Claude Desktop por completo

Uso

Una vez configurado, puedes interactuar con los horarios de oración a través de Claude Desktop utilizando consultas en lenguaje natural:

Ejemplos

Obtenga horarios de oración por ciudad/zona

  • ¿Cuáles son los horarios de oración en Kuala Lumpur hoy?
  • Mostrar horarios de oración para Ipoh, Malasia
  • Obtener horarios de oración para PRK02 (usando el código de zona)

Obtener horarios de oración por coordenadas

  • "¿Cuáles son los horarios de oración en las coordenadas 3.1390, 101.6869?"
  • Mostrar horario de oración para la ubicación 5.4141, 100.3288

Lista de zonas disponibles

  • Lista de todas las zonas horarias de oración en Malasia
  • "Muéstrame todos los códigos de zona JAKIM disponibles"

Referencia de API

Herramientas disponibles

El servidor MCP expone las siguientes herramientas a Claude:

get_prayer_times

Recupera los horarios de oración para una ciudad o código de zona específico en Malasia.

Parámetros :

  • city (cadena, valor predeterminado: "kuala lumpur"): nombre de la ciudad o código de zona (por ejemplo, "SGR03")
  • country (cadena, valor predeterminado: "malasia"): actualmente solo admite "malasia"
  • date (cadena, valor predeterminado: "hoy"): Fecha en formato AAAA-MM-DD o "hoy"

get_prayer_times_by_coordinates

Recupera tiempos de oración basados en coordenadas geográficas.

Parámetros :

  • latitude (flotante): coordenada de latitud
  • longitude (flotante): coordenada de longitud
  • date (cadena, valor predeterminado: "hoy"): Fecha en formato AAAA-MM-DD o "hoy"

list_zones

Enumera todas las zonas horarias de oración disponibles en Malasia con sus códigos correspondientes.

Información sobre el tiempo de oración

El servidor proporciona estos horarios de oración:

  • Imsak (hora de la comida antes del amanecer, si está disponible)
  • Fajr (oración del amanecer)
  • Syuruk/Amanecer
  • Dhuhr (oración del mediodía)
  • Asr (oración de la tarde)
  • Maghrib (oración del atardecer)
  • Isha (oración de la noche)

Cobertura de zona

El servidor actualmente admite todas las zonas JAKIM de Malasia. La búsqueda basada en coordenadas admite las siguientes áreas principales:

  • Kuala Lumpur/Selangor: SGR01-SGR04
  • Piedra: PRK01-PRK04
  • Penang: PNG01
  • Johor: JHR01
  • Kedah: KDH01
  • Terengganu: TRG01
  • Kelantan: KTN01
  • Malaca: MLK01

Solución de problemas

Problemas comunes

Claude no puede conectarse al servidor

  1. Verificar que las rutas de configuración sean absolutas y correctas
  2. Consulte los registros de Claude:
    # macOS tail -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
  3. Pruebe el servidor directamente:
    cd /path/to/mcp-server-malaysia-prayer-time python main.py

No hay horarios de oración disponibles

  1. Verificar la conectividad a Internet
  2. Compruebe si el código de zona es válido (use list_zones )
  3. La API puede no estar disponible temporalmente: inténtelo de nuevo más tarde

Ciudad no encontrada

Intente usar una ortografía diferente, una ciudad importante cercana o el código de zona apropiado.

Contribuyendo

¡Agradecemos sus contribuciones! Aquí le mostramos cómo contribuir:

  1. Bifurcar el repositorio
  2. Crear una rama de características: git checkout -b feature/amazing-feature
  3. Confirme sus cambios: git commit -m 'Add some amazing feature'
  4. Empujar a la rama: git push origin feature/amazing-feature
  5. Abrir una solicitud de extracción

Configuración de desarrollo

# Clone your fork git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git cd mcp-server-malaysia-prayer-time # Set up development environment python -m venv .venv source .venv/bin/activate pip install -e ".[dev]" # Installs dev dependencies # Run tests pytest

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud


-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor MCP que proporciona acceso a los datos de tiempos de oración de Malasia a través de Claude Desktop, lo que permite a los usuarios recuperar tiempos de oración para zonas específicas, enumerar las zonas de oración disponibles y verificar el estado actual de los tiempos de oración.

  1. Features
    1. Installation
      1. Prerequisites
      2. Option 1: Installation from GitHub
      3. Option 2: Using uv (Recommended)
    2. Configuration
      1. Configure Claude Desktop
    3. Usage
      1. Examples
    4. API Reference
      1. Available Tools
      2. Prayer Time Information
    5. Zone Coverage
      1. Troubleshooting
        1. Common Issues
      2. Contributing
        1. Development Setup
      3. License
        1. Acknowledgments
          ID: p0j28tsjdr