Malaysia Prayer Time MCP Server

by amanasmuei

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

local-only server

The server can only run on the client's local machine because it depends on local resources.

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. Características
    1. Instalación
      1. Prerrequisitos
      2. Opción 1: Instalación desde GitHub
      3. Opción 2: Uso de rayos UV (recomendado)
    2. Configuración
      1. Configurar Claude Desktop
    3. Uso
      1. Ejemplos
    4. Referencia de API
      1. Herramientas disponibles
      2. Información sobre el tiempo de oración
    5. Cobertura de zona
      1. Solución de problemas
        1. Problemas comunes
      2. Contribuyendo
        1. Configuración de desarrollo
      3. Licencia
        1. Expresiones de gratitud

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            An MCP server that allows checking local time on the client machine or current UTC time from an NTP server
            Last updated -
            14
            Python
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            A lightweight mcp server that tells you exactly what time is it based on your IP.
            Last updated -
            8
            Python
            MIT License
          • -
            security
            -
            license
            -
            quality
            An MCP server that enables Claude and other MCP clients to interact with Mattermost workspaces, providing channel management, messaging capabilities, and topic monitoring functionality.
            Last updated -
            TypeScript
          • A
            security
            A
            license
            A
            quality
            Model Context Protocol (MCP) server that provides weather forecast, warnings, water level associated with flood, and earthquake reports from Malaysia Government's Open API.
            Last updated -
            4
            Python
            MIT License

          View all related MCP servers

          ID: p0j28tsjdr