MCP Server Waktu Solat

🚀 馬來西亞祈禱時間MCP服務器

馬來西亞祈禱時間MCP服務器可精準提供馬來西亞境內各地點的伊斯蘭祈禱時間。它藉助模型上下文協議（MCP）與Claude Desktop無縫對接，讓您能通過AI助手即時獲取禱告時間表。

🚀 快速開始

馬來西亞祈禱時間MCP服務器能為您提供馬來西亞各地準確的伊斯蘭祈禱時間。您可通過AI助手，利用模型上下文協議（MCP）與Claude Desktop集成，即時獲取所需的禱告時間表。

✨ 主要特性

• 基於位置的時間：可獲取馬來西亞任意城市或區的祈禱時間。
• 座標支持：能依據緯度和經度座標查找祈禱時間。
• 區域代碼訪問：可直接使用JAKIM區域代碼進行查詢，例如輸入SGR03就能獲取吉隆坡的祈禱時間。
• 完整的每日祈禱時間表：能獲取全天的祈禱時間，包括拂曉、日出、正午、下午、日落、夜晚。
• 當前祈禱狀態：可確定當前和隨後的祈禱時間。
• 主要支持的城市和地區：涵蓋吉隆坡/雪蘭莪（SGR01 - SGR04）、霹靂（PRK01 - PRK04）、檳城（PNG01）、柔佛（JHR01）、吉打（KDH01）、登嘉樓（TRG01）、吉蘭丹（KTN01）和馬六甲（MLK01）。
• 多語言支持：目前支持英語和中文界面。
• 用戶友好界面：操作界面簡潔直觀，方便查詢和瀏覽祈禱時間。
• 數據準確可靠：採用JAKIM認證的官方祈禱時間數據源。
• 離線訪問：即便在無互聯網連接的情況下，也可訪問已緩存的數據。

📦 安裝指南

安裝步驟：

1. 克隆倉庫：

git clone https://github.com/amanasmuei/malaysia-prayer-times.git
cd malaysia-prayer-times

2. 創建虛擬環境並安裝依賴：

python -m venv .venv
source .venv/bin/activate  # 對於 macOS/Linux
. .venv/bin/activate       # 對於 Windows
pip install requirements.txt

3. 啟動應用：

python app.py

💻 使用示例

基礎用法

# 打開終端並運行以下命令啟動應用程序
python app.py

高級用法

# 啟動應用後，在瀏覽器中訪問 http://localhost:8000
# 選擇所需的城市或輸入地理座標
# 查看顯示的祈禱時間

📚 詳細文檔

使用方法：

1. 打開終端並運行 python app.py 啟動應用程序。
2. 在瀏覽器中訪問 http://localhost:8000。
3. 選擇所需的城市或輸入地理座標。
4. 查看顯示的祈禱時間。

貢獻

歡迎貢獻！以下是您可以參與的方式：

1. 報告問題：在GitHub上提交您遇到的問題。
2. 修復錯誤：為已報告的錯誤提供修復方案。
3. 添加新功能：為應用程序增加新的有用功能。
4. 改進文檔：優化項目文檔，使其更清晰易懂。

開發設置

1. 克隆您的 fork：

git clone https://github.com/yourusername/malaysia-prayer-times.git
cd malaysia-prayer-times

2. 設置開發環境：

python -m venv .venv
source .venv/bin/activate  # 對於 macOS/Linux
. .venv/bin/activate       # 對於 Windows
pip install -e ".[dev]"    # 安裝開發依賴項

3. 運行測試：

pytest

📄 許可證

本項目採用MIT License，詳情請參閱LICENSE文件。

致謝

• waktusolat.app - 提供祈禱時間數據 API
• Model Context Protocol - MCP 框架的提供者
• JAKIM - 提供官方祈禱時間數據
• Claude Desktop - 提供AI集成平臺