Malaysia Prayer Time for Claude Desktop

<div align="center"> <img src="public/images/banner.svg" alt="Malaysia Prayer Time MCP Server" width="800"> </div>

<p align="center"> <a href="#features">特性</a> • <a href="#installation">安装</a> • <a href="#configuration">配置</a> • <a href="#usage">使用</a> • <a href="#api-reference">API 参考</a> • <a href="#troubleshooting">问题排查</a> • <a href="#contributing">贡献</a> • <a href="#license">许可证</a> </p>

---

概述

Malaysia Prayer Time MCP Server 为马来西亚各地提供准确的伊斯兰祈祷时间。该服务器实现了模型上下文协议 (MCP)，可与 Claude Desktop 无缝集成，从而直接通过您的 AI 助手提供实时祈祷时间表。

该服务器利用 waktusolat.app API 来检索 JAKIM 验证的祈祷时间，并支持按城市、区域代码或坐标进行搜索。

特性

✅ 基于位置的时间：获取马来西亚任何城市或地区的祈祷时间 ✅ 坐标支持：使用纬度和经度坐标查找祈祷时间 ✅ 区域代码访问：直接使用 JAKIM 区域代码进行查询（例如，吉隆坡的 SGR03） ✅ 完整祈祷时间表：检索所有每日祈祷时间（晨礼、日出、晌礼、晡礼、昏礼、宵礼） ✅ 当前祈祷状态：确定当前和下一个祈祷时间 ✅ 强大的错误处理：优雅地处理网络问题和 API 更改 ✅ 无缝 Claude 集成：通过 MCP 与 Claude Desktop 清晰集成

安装

前提条件

• Python 3.10 或更高版本
• Claude Desktop（最新版本）
• pip 或 uv 包管理器

选项 1：从 GitHub 安装

# 克隆存储库
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装依赖项
pip install -e .

选项 2：使用 uv（推荐）

# 克隆存储库
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# 使用 uv 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装依赖项
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 (string, default: "kuala lumpur"): 城市名称或区域代码（例如，“SGR03”）
• country (string, default: "malaysia"): 目前仅支持“malaysia”
• date (string, default: "today"): YYYY-MM-DD 格式的日期或“today”

get_prayer_times_by_coordinates

根据地理坐标检索祈祷时间。

参数:

• latitude (float): 纬度坐标
• longitude (float): 经度坐标
• date (string, default: "today"): YYYY-MM-DD 格式的日期或“today”

list_zones

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

祈祷时间信息

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

• Imsak（黎明前用餐时间，如果可用）
• Fajr（晨礼）
• Syuruk/Sunrise（日出）
• Dhuhr（晌礼）
• Asr（晡礼）
• Maghrib（昏礼）
• Isha（宵礼）

区域覆盖

该服务器目前支持马来西亚的所有 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

开发设置

# 克隆您的 fork
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# 设置开发环境
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"  # 安装开发依赖项

# 运行测试
pytest

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• waktusolat.app - 用于提供祈祷时间数据 API
• 模型上下文协议 - 用于 MCP 框架
• JAKIM - 用于官方祈祷时间
• Claude Desktop - 用于 AI 集成平台

---

<div align="center"> <p>由 <a href="https://github.com/amanasmuei">abdul rahman m asmuei</a> 创建</p> <p>amanasmuei@gmail.com</p> </div>