Servidor MCP de la Hora de Oración de Malasia

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

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

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"
        }
    }
}

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

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

No hay horarios de oración disponibles

Verificar la conectividad a Internet
Compruebe si el código de zona es válido (use list_zones )
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:

Bifurcar el repositorio
Crear una rama de características: git checkout -b feature/amazing-feature
Confirme sus cambios: git commit -m 'Add some amazing feature'
Empujar a la rama: git push origin feature/amazing-feature
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

waktusolat.app - Para proporcionar la API de datos del tiempo de oración
Protocolo de contexto del modelo : para el marco MCP
JAKIM - Para los horarios oficiales de oración
Claude Desktop: para la plataforma de integración de IA