MCP Server Malaysia Prayer Time

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

本項目是一個基於模型上下文協議（MCP）的馬來西亞祈禱時間服務器。該服務器藉助 waktusolat.app 提供的 API 獲取官方祈禱時間數據，並與 Claude Desktop 集成，為用戶提供準確的祈禱時間信息。

🚀 快速開始

本項目是一個基於模型上下文協議（MCP）的馬來西亞祈禱時間服務器，可通過 waktusolat.app 的 API 獲取官方祈禱時間數據，並與 Claude Desktop 集成。以下是快速開始的步驟：

1. 克隆倉庫：

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

2. 創建虛擬環境並激活：

   python -m venv .venv
   source .venv/bin/activate  # 對於 macOS 和 Linux
   # 或者
   .venv\Scripts\activate  # 對於 Windows
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

✨ 主要特性

• 獲取基於城市或座標位置的祈禱時間。
• 支持以下時間點：
  • Imsak（破曉前齋戒時間，如有提供）
  • Fajr（拂曉祈禱）
  • Syuruk/Sunrise（日出）
  • Dhuhr（正午祈禱）
  • Asr（下午祈禱）
  • Maghrib（日落祈禱）
  • Isha（夜晚祈禱）

📦 安裝指南

服務器配置

1. 在項目根目錄創建 config.json 文件。
2. 添加以下內容：

   {
     "api_key": "your_api_key_from_waktusolat",
     "debug_mode": true,
     "logging": {
       "level": "INFO",
       "file_path": "server.log"
     }
   }
   

3. 設置環境變量 NODE_ENV 為 production 或保留默認。

客戶端配置

1. 在 client/config.js 中添加：

   export const API_BASE_URL = 'http://localhost:5000';
   export const TIMEOUT = 5000;
   

💻 使用示例

基礎用法

獲取基於城市的位置祈禱時間

const response = await fetch(`${API_BASE_URL}/prayer-times?city=Kuala%20Lumpur&country=Malaysia`);

獲取基於座標的位置祈禱時間

const response = await fetch(`${API_BASE_URL}/coordinates?lat=3.14&lon=101.69`);

📚 詳細文檔

API 參考

端點說明

• /prayer-times

  • 方法: GET
  • 參數:
    • city (必填)：城市名稱
    • country (必填)：國家名稱，默認為馬來西亞
    • date (可選)：日期，格式為 YYYY-MM-DD 或 "today"

• /coordinates

  • 方法: GET
  • 參數:
    • lat (必填)：緯度
    • lon (必填)：經度
    • date (可選)：日期，格式為 YYYY-MM-DD 或 "today"

響應結構

{
  "imsak": "05:30",
  "fajr": "06:00",
  "sunrise": "07:00",
  "dhuhr": "12:00",
  "asr": "15:00",
  "maghrib": "18:00",
  "isha": "19:30"
}

🔧 技術細節

故障排除

問題：無法連接到服務器

1. 確認配置文件路徑是否正確且存在。
2. 檢查日誌：

   # macOS/Linux
   tail -f ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type %APPDATA%\Claude\Logs\mcp*.log
   

3. 測試服務器是否運行：

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

🤝 貢獻指南

歡迎貢獻！

1. 叉倉庫。
2. 創建功能分支：git checkout -b feature/amazing-feature。
3. 提交更改：git commit -m "添加了新功能"。
4. 推送到原點並創建拉取請求。

📄 許可證

本項目遵循麻省理工學院許可協議。

附錄

• 支持的城市列表請參考 waktusolat.app 官方文檔。
• 詳細的錯誤處理和日誌記錄請查看logging模塊。