Malaysia Prayer Time MCP Server

Fornece horários precisos de orações islâmicas para locais em toda a Malásia usando a API waktusolat.app.

GitHubExperimente este MCPPatrocinado

Documentação

MseeP.ai Security Assessment Badge

Malaysia Prayer Time MCP Server

Recursos • Instalação • Configuração • Uso • Referência da API • Solução de Problemas • Contribuição • Licença

Visão Geral

O Malaysia Prayer Time MCP Server fornece horários precisos de orações islâmicas para locais em toda a Malásia. Este servidor implementa o Model Context Protocol (MCP) para integrar-se perfeitamente ao Claude Desktop, entregando cronogramas de oração em tempo real diretamente através do seu assistente de IA.

O servidor utiliza a API waktusolat.app para recuperar horários de oração verificados pela JAKIM e suporta busca por cidade, código de zona ou coordenadas.

Recursos

✅ Horários Baseados em Localização: Obtenha horários de oração para qualquer cidade ou distrito na Malásia
✅ Suporte a Coordenadas: Encontre horários de oração usando coordenadas de latitude e longitude
✅ Acesso por Código de Zona: Consulte diretamente usando códigos de zona JAKIM (ex.: SGR03 para Kuala Lumpur)
✅ Cronograma Completo de Orações: Recupere todos os horários diários de oração (Fajr, Nascer do Sol, Dhuhr, Asr, Maghrib, Isha)
✅ Status Atual da Oração: Determine os horários de oração atual e próximo
✅ Tratamento Robusto de Erros: Gerenciamento gracioso de problemas de rede e mudanças na API
✅ Integração Perfeita com Claude: Integração limpa com o Claude Desktop via MCP

Instalação

Pré-requisitos

  • Python 3.10 ou superior
  • Claude Desktop (versão mais recente)
  • Gerenciador de pacotes pip ou uv

Opção 1: Instalação a partir do 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 .

Opção 2: Usando 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 .

Configuração

Configurar o Claude Desktop

  1. Crie ou edite o arquivo de configuração do Claude Desktop:

macOS:

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

Windows:

mkdir -p %APPDATA%\Claude
notepad %APPDATA%\Claude\claude_desktop_config.json
  1. Adicione a seguinte configuração (ajuste os caminhos de acordo com sua configuração):
{
    "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. Reinicie o Claude Desktop completamente

Uso

Uma vez configurado, você pode interagir com os horários de oração através do Claude Desktop usando consultas em linguagem natural:

Exemplos

Obter Horários de Oração por Cidade/Zona

  • "Quais são os horários de oração para Kuala Lumpur hoje?"
  • "Mostre os horários de oração para Ipoh, Malásia"
  • "Obtenha os horários de oração para PRK02" (usando código de zona)

Obter Horários de Oração por Coordenadas

  • "Quais são os horários de oração nas coordenadas 3.1390, 101.6869?"
  • "Mostre o cronograma de oração para a localização 5.4141, 100.3288"

Listar Zonas Disponíveis

  • "Liste todas as zonas de horário de oração na Malásia"
  • "Mostre-me todos os códigos de zona JAKIM disponíveis"

Referência da API

Ferramentas Disponíveis

O servidor MCP expõe as seguintes ferramentas ao Claude:

get_prayer_times

Recupera horários de oração para uma cidade ou código de zona específico na Malásia.

Parâmetros:

  • city (string, padrão: "kuala lumpur"): Nome da cidade ou código de zona (ex.: "SGR03")
  • country (string, padrão: "malaysia"): Atualmente suporta apenas "malaysia"
  • date (string, padrão: "today"): Data no formato AAAA-MM-DD ou "today"

get_prayer_times_by_coordinates

Recupera horários de oração com base em coordenadas geográficas.

Parâmetros:

  • latitude (float): Coordenada de latitude
  • longitude (float): Coordenada de longitude
  • date (string, padrão: "today"): Data no formato AAAA-MM-DD ou "today"

list_zones

Lista todas as zonas de horário de oração disponíveis na Malásia com seus códigos correspondentes.

Informações sobre Horários de Oração

O servidor fornece estes horários de oração:

  • Imsak (horário da refeição pré-amanhecer, se disponível)
  • Fajr (oração do amanhecer)
  • Syuruk/Nascer do Sol
  • Dhuhr (oração do meio-dia)
  • Asr (oração da tarde)
  • Maghrib (oração do pôr do sol)
  • Isha (oração da noite)

Cobertura de Zonas

O servidor atualmente suporta todas as zonas JAKIM na Malásia. A busca por coordenadas suporta estas áreas principais:

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

Solução de Problemas

Problemas Comuns

Claude Não Consegue Conectar ao Servidor

  1. Verifique se os caminhos de configuração são absolutos e corretos

  2. Verifique os logs do Claude:

    # macOS
tail -f ~/Library/Logs/Claude/mcp*.log

# Windows
type %APPDATA%\Claude\Logs\mcp*.log

  3. Teste o servidor diretamente:

    cd /path/to/mcp-server-malaysia-prayer-time
python main.py

Nenhum Horário de Oração Disponível

  1. Verifique a conectividade com a internet
  2. Verifique se o código de zona é válido (use list_zones)
  3. A API pode estar temporariamente indisponível - tente novamente mais tarde

Cidade Não Encontrada

Tente usar uma grafia diferente, uma cidade grande próxima ou o código de zona apropriado

Contribuição

Contribuições são bem-vindas! Veja como você pode contribuir:

  1. Faça um fork do repositório
  2. Crie um branch de recurso: git checkout -b feature/amazing-feature
  3. Faça commit das suas alterações: git commit -m 'Add some amazing feature'
  4. Envie para o branch: git push origin feature/amazing-feature
  5. Abra um Pull Request

Configuração de Desenvolvimento

# 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

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos

  • waktusolat.app - Por fornecer a API de dados de horários de oração
  • Model Context Protocol - Pelo framework MCP
  • JAKIM - Pelos horários oficiais de oração
  • Claude Desktop - Pela plataforma de integração de IA

Criado por abdul rahman m asmuei

amanasmuei@gmail.com