mcp-server-waktu-solat

🚀 马来西亚祈祷时间MCP服务器

马来西亚祈祷时间MCP服务器可精准提供马来西亚境内各地点的伊斯兰祈祷时间。它借助模型上下文协议（MCP）与Claude Desktop无缝对接，让您能通过AI助手实时获取祷告时间表。

🚀 快速开始

马来西亚祈祷时间MCP服务器能为您提供马来西亚各地准确的伊斯兰祈祷时间。您可通过AI助手，利用模型上下文协议（MCP）与Claude Desktop集成，实时获取所需的祷告时间表。

✨ 主要特性

• 基于位置的时间：可获取马来西亚任意城市或区的祈祷时间。
• 坐标支持：能依据纬度和经度坐标查找祈祷时间。
• 区域代码访问：可直接使用JAKIM区域代码进行查询，例如输入SGR03就能获取吉隆坡的祈祷时间。
• 完整的每日祈祷时间表：能获取全天的祈祷时间，包括拂晓、日出、正午、下午、日落、夜晚。
• 当前祈祷状态：可确定当前和随后的祈祷时间。
• 主要支持的城市和地区：涵盖吉隆坡/雪兰莪（SGR01 - SGR04）、霹雳（PRK01 - PRK04）、槟城（PNG01）、柔佛（JHR01）、吉打（KDH01）、登嘉楼（TRG01）、吉兰丹（KTN01）和马六甲（MLK01）。
• 多语言支持：目前支持英语和中文界面。
• 用户友好界面：操作界面简洁直观，方便查询和浏览祈祷时间。
• 数据准确可靠：采用JAKIM认证的官方祈祷时间数据源。
• 离线访问：即便在无互联网连接的情况下，也可访问已缓存的数据。

📦 安装指南

安装步骤：

1. 克隆仓库：

git clone https://github.com/amanasmuei/malaysia-prayer-times.git
cd malaysia-prayer-times

2. 创建虚拟环境并安装依赖：

python -m venv .venv
source .venv/bin/activate  # 对于 macOS/Linux
. .venv/bin/activate       # 对于 Windows
pip install requirements.txt

3. 启动应用：

python app.py

💻 使用示例

基础用法

# 打开终端并运行以下命令启动应用程序
python app.py

高级用法

# 启动应用后，在浏览器中访问 http://localhost:8000
# 选择所需的城市或输入地理坐标
# 查看显示的祈祷时间

📚 详细文档

使用方法：

1. 打开终端并运行 python app.py 启动应用程序。
2. 在浏览器中访问 http://localhost:8000。
3. 选择所需的城市或输入地理坐标。
4. 查看显示的祈祷时间。

贡献

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

1. 报告问题：在GitHub上提交您遇到的问题。
2. 修复错误：为已报告的错误提供修复方案。
3. 添加新功能：为应用程序增加新的有用功能。
4. 改进文档：优化项目文档，使其更清晰易懂。

开发设置

1. 克隆您的 fork：

git clone https://github.com/yourusername/malaysia-prayer-times.git
cd malaysia-prayer-times

2. 设置开发环境：

python -m venv .venv
source .venv/bin/activate  # 对于 macOS/Linux
. .venv/bin/activate       # 对于 Windows
pip install -e ".[dev]"    # 安装开发依赖项

3. 运行测试：

pytest

📄 许可证

本项目采用MIT License，详情请参阅LICENSE文件。

致谢

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