JinDaGe - mcp-server-malaysia-prayer-time MCP Details

article

README

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

本项目是一个基于模型上下文协议（MCP）的马来西亚祈祷时间服务器。该服务器借助 waktusolat.app 提供的 API 获取官方祈祷时间数据，并与 Claude Desktop 实现集成，为用户提供准确的祈祷时间信息。

🚀 快速开始

本项目是一个基于模型上下文协议（MCP）的马来西亚祈祷时间服务器。它通过 waktusolat.app 提供的 API 获取官方祈祷时间数据，并与 Claude Desktop 集成。

✨ 主要特性

获取基于城市或坐标位置的祈祷时间。
支持以下时间点：
- Imsak（破晓前斋戒时间，如有提供）
- Fajr（拂晓祈祷）
- Syuruk/Sunrise（日出）
- Dhuhr（正午祈祷）
- Asr（下午祈祷）
- Maghrib（日落祈祷）
- Isha（夜晚祈祷）

📦 安装指南

克隆仓库：

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

创建虚拟环境并激活：

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

安装依赖项：
```
pip install -r requirements.txt
```

🔧 配置指南

服务器配置

在项目根目录创建 config.json 文件。

添加以下内容：

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

设置环境变量 NODE_ENV 为 production 或保留默认。

客户端配置

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

🛠️ 故障排除

问题：无法连接到服务器

确认配置文件路径是否正确且存在。

检查日志：

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

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

测试服务器是否运行：

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

🤝 贡献指南

欢迎贡献！

叉仓库。
创建功能分支：git checkout -b feature/amazing-feature。
提交更改：git commit -m "添加了新功能"。
推送到原点并创建拉取请求。

📄 许可证

本项目遵循麻省理工学院许可协议。

附录

支持的城市列表请参考 waktusolat.app 官方文档。
详细的错误处理和日志记录请查看 logging 模块。

mcp-server-malaysia-prayer-time