Features • Installation • Configuration • Usage • API Reference • Troubleshooting • Contributing • License
______________________________________________________________________
概述
马来西亚祈祷时间MCP服务器为马来西亚各地提供准确的伊斯兰祈祷时间。该服务器实现了模型上下文协议（MCP），与Claude Desktop无缝集成，直接通过您的AI助手提供实时祈祷时间表。
服务器使用waktusolat.appneneneba API检索JAKIM验证的祈祷时间，并支持按城市、地区代码或坐标进行搜索。
特性
✅ 基于位置的时间：获取马来西亚任何城市或地区的祈祷时间\ ✅ 协调支持：使用纬度和经度坐标查找祈祷时间\ ✅ 区域代码访问：使用JAKIM区号直接查询（例如。， SGR03 吉隆坡）\ ✅ 完整的祷告时间表：检索所有每日祈祷时间（Fajr、Sunrise、Dhuhr、Asr、Maghrib、Isha）\ ✅ 当前祷告状态：确定当前和下一个祈祷时间\ ✅ 稳健的错误处理：优雅地处理网络问题和API更改\ ✅ 无缝集成Claude：通过MCP与Claude Desktop无缝集成
安装
先决条件
- Python 3.10或更高版本
- 克劳德桌面（最新版本）
pip或uv包管理器
选项1：从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 .选项2：使用紫外线（推荐）
# 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 .配置
配置Claude桌面
- 创建或编辑Claude Desktop配置文件：
macOS:
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json视窗:
mkdir -p %APPDATA%\Claude
notepad %APPDATA%\Claude\claude_desktop_config.json- 添加以下配置（根据您的设置调整路径）：
{
"mcpServers": {
"malaysia-prayer-time": {
"command": "/absolute/path/to/your/.venv/bin/python",
"args": [
"main.py"
],
"cwd": "/absolute/path/to/mcp-server-malaysia-prayer-time"
}
}
}- 完全重新启动克劳德桌面
用法
配置后，您可以使用自然语言查询通过Claude Desktop与祈祷时间进行交互：
例子
按城市/地区获取祈祷时间
- “吉隆坡今天的祈祷时间是什么时候？”
- “为马来西亚怡保展示祈祷时间”
- “获取PRK02的祈祷时间”（使用区号）
按坐标获取祈祷时间
- “坐标3.1390101.6869处的祈祷时间是多少？”
- “显示位置5.4141100.3288的祈祷时间表”
列出可用区域
- “列出马来西亚的所有祈祷时区”
- “显示所有可用的JAKIM区号”
api参考
可用工具
MCP服务器向Claude公开了以下工具：
get_prayer_times
检索马来西亚特定城市或区号的祈祷时间。
参数:
city（字符串，默认值：“kuala lumpur”）：城市名称或区号（例如“SGR03”）country（string，默认值：“malaysia”）：目前仅支持“Malaysias”date（字符串，默认值：“today”）：日期格式为YYYY-MM-DD或“today
get_prayer_times_by_coordinates
根据地理坐标检索祈祷时间。
参数:
latitude（浮动）：纬度坐标longitude（float）：经度坐标date（字符串，默认值：“today”）：日期格式为YYYY-MM-DD或“today
list_zones
列出马来西亚所有可用的祈祷时区及其相应的代码。
祷告时间信息
服务器提供以下祈祷时间：
- Imsak（黎明前用餐时间，如果有的话）
- Fajr（黎明祈祷）
- 日出/Sunrise
- Dhuhr（中午祈祷）
- Asr（下午祷告）
- Maghrib（日落祈祷）
- Isha（夜间祈祷）
区域覆盖范围
该服务器目前支持马来西亚的所有JAKIM区域。基于坐标的查找支持以下主要领域：
- 吉隆坡/雪兰莪：SGR01-SGR04
- 银色：PRK01-PRK04
- 槟城：PNG01
- 柔佛州：JHR01
- 编号： KDH01
- 编号：TRG01
- 吉兰丹：KTN01
- 马六甲：MLK01
故障排除
常见问题
Claude无法连接到服务器
- 验证配置路径是否绝对正确
- 检查克劳德日志：
# macOS
tail -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\Logs\mcp*.log- 直接测试服务器：
cd /path/to/mcp-server-malaysia-prayer-time
python main.py没有可用的祈祷时间
- 验证互联网连接
- 检查区号是否有效（使用
list_zones) - API可能暂时不可用-请稍后再试
未找到城市
尝试使用其他拼写、附近的主要城市或适当的区号
贡献
欢迎投稿！以下是您如何做出贡献：
- 分叉存储库
- 创建要素分支：
git checkout -b feature/amazing-feature - 提交您的更改：
git commit -m 'Add some amazing feature' - 推到分支：
git push origin feature/amazing-feature - 打开拉取请求
开发设置
# 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许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
致谢
- Waktusolat.app -用于提供祈祷时间数据API
- 模型上下文协议 -对于MCP框架
- 雅加达-官方祈祷时间
- Claude Desktop-用于人工智能集成平台
______________________________________________________________________
Created by abdul rahman m asmuei
amanasmuei@gmail.com