🚀 马来西亚祈祷时间服务器

本项目是一个基于模型上下文协议（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模块。