Malaysia Prayer Time MCP Server

](https://mseep.ai/app/amanasmuei-mcp-server-malaysia-prayer-time)

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桌面

1. 创建或编辑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

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

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

1. 完全重新启动克劳德桌面

用法

配置后，您可以使用自然语言查询通过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无法连接到服务器

1. 验证配置路径是否绝对正确

1. 检查克劳德日志：

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

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

1. 直接测试服务器：

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

没有可用的祈祷时间

1. 验证互联网连接
2. 检查区号是否有效（使用 list_zones)
3. API可能暂时不可用-请稍后再试

未找到城市

尝试使用其他拼写、附近的主要城市或适当的区号

贡献

欢迎投稿！以下是您如何做出贡献：

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/amazing-feature
3. 提交您的更改： git commit -m 'Add some amazing feature'
4. 推到分支： git push origin feature/amazing-feature
5. 打开拉取请求

开发设置

# 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