Malaysia Prayer Time for Claude Desktop

功能 • 安装 • 配置 • 使用方法 • API 参考 • 故障排除 • 参与贡献 • 许可证

---

概述

马来西亚祈祷时间 MCP 服务可提供马来西亚各地准确的伊斯兰祈祷时间。此服务实现了模型上下文协议（MCP），可与 Claude Desktop 无缝集成，通过 AI 助手直接提供实时祈祷时间表。

此服务使用 waktusolat.app API 获取经 JAKIM 验证的祈祷时间，并支持按城市、区域代码或坐标进行搜索。

功能

✅ 按地点查询时间：获取马来西亚任意城市或地区的祈祷时间
✅ 支持坐标查询：使用纬度和经度坐标查询祈祷时间
✅ 按区域代码查询：直接使用 JAKIM 区域代码查询（例如，吉隆坡的 SGR03）
✅ 完整祈祷时间表：获取每日所有祈祷时间（晨礼、日出、晌礼、晡礼、昏礼、宵礼）
✅ 当前祈祷状态：确定当前和下一次祈祷时间
✅ 健壮的错误处理：妥善处理网络问题和 API 变更
✅ 与 Claude 无缝集成：通过 MCP 与 Claude Desktop 简洁集成

安装

前提条件

• Python 3.10 或更高版本
• Claude Desktop（最新版本）
• 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：使用 uv（推荐）

# 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 Desktop

1. 创建或编辑 Claude Desktop 配置文件：

macOS：

mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

mkdir -p %APPDATA%\Claude
notepad %APPDATA%\Claude\claude_desktop_config.json

2. 添加以下配置（根据你的设置调整路径）：

{
    "mcpServers": {
        "malaysia-prayer-time": {
            "command": "/absolute/path/to/your/.venv/bin/python",
            "args": [
                "main.py"
            ],
            "cwd": "/absolute/path/to/mcp-server-malaysia-prayer-time"
        }
    }
}

3. 完全重启 Claude Desktop

使用方法

配置完成后，你可以在 Claude Desktop 中使用自然语言查询祈祷时间：

示例

按城市/区域查询祈祷时间

• “今天吉隆坡的祈祷时间是什么？”
• “显示马来西亚怡保的祈祷时间”
• “查询 PRK02 的祈祷时间”（使用区域代码）

按坐标查询祈祷时间

• “坐标 3.1390, 101.6869 处的祈祷时间是什么？”
• “显示位置 5.4141, 100.3288 的祈祷时间表”

列出可用区域

• “列出马来西亚的所有祈祷时间区域”
• “显示所有可用的 JAKIM 区域代码”

API 参考

可用工具

此 MCP 服务向 Claude 提供以下工具：

get_prayer_times

获取马来西亚特定城市或区域代码的祈祷时间。

参数：

• city（字符串，默认值："kuala lumpur"）：城市名称或区域代码（例如，"SGR03"）
• country（字符串，默认值："malaysia"）：目前仅支持 "malaysia"
• date（字符串，默认值："today"）：YYYY-MM-DD 格式的日期或 "today"

get_prayer_times_by_coordinates

根据地理坐标获取祈祷时间。

参数：

• latitude（浮点数）：纬度坐标
• longitude（浮点数）：经度坐标
• date（字符串，默认值："today"）：YYYY-MM-DD 格式的日期或 "today"

list_zones

列出马来西亚所有可用的祈祷时间区域及其对应代码。

祈祷时间信息

此服务提供以下祈祷时间：

• 伊姆萨克（黎明前用餐时间，如有）
• 晨礼（黎明祈祷）
• Syuruk/日出
• 晌礼（正午祈祷）
• 晡礼（午后祈祷）
• 昏礼（日落祈祷）
• 宵礼（夜间祈祷）

区域覆盖范围

该服务目前支持马来西亚所有 JAKIM 区域。基于坐标的查询支持以下主要地区：

• 吉隆坡／雪兰莪：SGR01-SGR04
• 霹雳：PRK01-PRK04
• 槟城：PNG01
• 柔佛：JHR01
• 吉打：KDH01
• 登嘉楼：TRG01
• 吉兰丹：KTN01
• 马六甲：MLK01

故障排除

常见问题

Claude 无法连接到服务

1. 确认配置路径是绝对路径且正确

2. 查看 Claude 日志：

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

3. 直接测试服务：

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

没有可用的祈祷时间

1. 确认网络连接正常
2. 检查区域代码是否有效（使用 list_zones）
3. API 可能暂时不可用，请稍后重试

找不到城市

尝试使用其他拼写、附近的大城市或相应的区域代码

贡献

欢迎贡献！以下是参与贡献的方式：

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m 'Add some amazing feature'
4. 推送到该分支：git push origin feature/amazing-feature
5. 创建 Pull Request

开发环境设置

# 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 许可证，详情请参阅 LICENSE 文件。

致谢

• waktusolat.app - 提供祈祷时间数据 API
• Model Context Protocol - 提供 MCP 框架
• JAKIM - 提供官方祈祷时间
• Claude Desktop - 提供 AI 集成平台

---