Overview

基本能力

产品定位

Malaysia Prayer Time MCP Server 是一个专门为马来西亚穆斯林社区设计的祈祷时间查询服务，通过与 Claude Desktop 集成，提供便捷的祈祷时间查询功能。

核心功能

• 基于位置的祈祷时间：获取马来西亚任何城市或地区的祈祷时间
• 坐标支持：使用经纬度坐标查询祈祷时间
• 区域代码访问：直接使用 JAKIM 区域代码查询（例如 SGR03 代表吉隆坡）
• 完整的祈祷时间表：获取每日所有祈祷时间（Fajr、Sunrise、Dhuhr、Asr、Maghrib、Isha）
• 当前祈祷状态：确定当前和下一个祈祷时间
• 强大的错误处理：优雅处理网络问题和 API 变更
• 无缝 Claude 集成：通过 MCP 与 Claude Desktop 无缝集成

适用场景

• 穆斯林个人日常祈祷时间查询
• 清真寺或伊斯兰组织管理祈祷时间
• 开发与伊斯兰祈祷时间相关的应用程序
• 旅行者查询不同地区的祈祷时间

工具列表

1. get_prayer_times
2. 功能：检索马来西亚特定城市或区域代码的祈祷时间

3. 参数：city（城市名或区域代码）、country（仅支持"malaysia"）、date（日期格式为 YYYY-MM-DD 或 "today"）

4. get_prayer_times_by_coordinates

5. 功能：基于地理坐标检索祈祷时间

6. 参数：latitude（纬度）、longitude（经度）、date（日期格式为 YYYY-MM-DD 或 "today"）

7. list_zones

8. 功能：列出马来西亚所有可用的祈祷时间区域及其对应代码

常见问题解答

1. Claude 无法连接到服务器
2. 验证配置路径是否正确
3. 检查 Claude 日志

4. 直接测试服务器

5. 没有可用的祈祷时间

6. 验证互联网连接
7. 检查区域代码是否有效

8. API 可能暂时不可用

9. 找不到城市

10. 尝试使用不同的拼写、附近的主要城市或适当的区域代码

使用教程

使用依赖

• 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 .

调试方式

1. 测试服务器直接运行 bash cd /path/to/mcp-server-malaysia-prayer-time python main.py

2. 检查 Claude 日志

3. macOS: bash tail -f ~/Library/Logs/Claude/mcp*.log
4. Windows: bash type %APPDATA%\Claude\Logs\mcp*.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。