AI导哈

伊斯兰祈祷时间服务器

马来西亚伊斯兰祈祷时间MCP服务器提供准确的马来西亚各地伊斯兰祈祷时间，支持通过城市、区域代码或坐标查询，并与Claude Desktop无缝集成。

  • by amanasmuei
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 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. 验证配置路径是否绝对正确

  2. 检查克劳德日志：

    # 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. 分叉存储库
  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许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

Created by abdul rahman m asmuei

amanasmuei@gmail.com

相关 MCP