概述
马来西亚祈祷时间 MCP 服务器提供马来西亚各地准确的伊斯兰祈祷时间。该服务器采用模型上下文协议 (MCP),可与 Claude Desktop 无缝集成,并通过您的 AI 助手直接提供实时祈祷时间表。
该服务器利用 waktusolat.app API 检索 JAKIM 验证的祈祷时间,并支持按城市、区域代码或坐标进行搜索。
特征
✅基于位置的时间:获取马来西亚任何城市或地区的祷告时间
✅坐标支持:使用经纬度坐标查找祈祷时间
✅区域代码访问:使用 JAKIM 区域代码直接查询(例如,吉隆坡为SGR03
)
✅完整的祷告时间表:检索所有每日祷告时间(晨礼、日出、晌礼、晡礼、昏礼、宵礼)
✅当前祈祷状态:确定当前和下一次祈祷时间
✅强大的错误处理:优雅地处理网络问题和 API 更改
✅无缝 Claude 集成:通过 MCP 与 Claude Desktop 无缝集成
安装
先决条件
- Python 3.10 或更高版本
- Claude 桌面(最新版本)
pip
或uv
包管理器
选项 1:从 GitHub 安装
选项 2:使用 uv(推荐)
配置
配置 Claude 桌面
- 创建或编辑 Claude Desktop 配置文件:
macOS 系统:
窗户:
- 添加以下配置(根据您的设置调整路径):
- 完全��启Claude Desktop
用法
配置完成后,您可以使用自然语言查询通过 Claude Desktop 与祈祷时间进行交互:
示例
按城市/区域获取祷告时间
- “今天吉隆坡的祈祷时间是几点?”
- “显示马来西亚怡保的祈祷时间”
- “获取 PRK02 的祈祷时间”(使用区域代码)
通过坐标获取祷告时间
- “坐标 3.1390, 101.6869 处的祈祷时间是几点?”
- “显示 5.4141, 100.3288 位置的祈祷时间表”
列出可用区域
- “列出马来西亚所有祈祷时区”
- “显示所有可用的 JAKIM 区域代码”
API 参考
可用工具
MCP 服务器向 Claude 公开了以下工具:
get_prayer_times
检索马来西亚特定城市或区域代码的祈祷时间。
参数:
city
(字符串,默认值:“kuala lumpur”):城市名称或区域代码(例如,“SGR03”)country
(字符串,默认值:“马来西亚”):目前仅支持“马来西亚”date
(字符串,默认值:“今天”):YYYY-MM-DD 格式的日期或“今天”
get_prayer_times_by_coordinates
根据地理坐标检索祈祷时间。
参数:
latitude
(浮点数):纬度坐标longitude
(浮点数):经度坐标date
(字符串,默认值:“今天”):YYYY-MM-DD 格式的日期或“今天”
list_zones
列出马来西亚所有可用的祈祷时区及其相应的代码。
祷告时间信息
服务器提供以下祈祷时间:
- Imsak(黎明前的用餐时间,如有)
- 晨礼(黎明祈祷)
- 苏鲁克/日出
- 晌礼(午间祈祷)
- 晡礼(下午祈祷)
- 马格里布(日落祈祷)
- 伊莎(夜间祈祷)
区域覆盖
该服务器目前支持马来西亚所有 JAKIM 区域。基于坐标的查找支持以下主要区域:
- 吉隆坡/雪兰莪:SGR01-SGR04
- 霹雳州:PRK01-PRK04
- 槟城:PNG01
- 柔佛:JHR01
- 吉打:KDH01
- 登嘉楼:TRG01
- 吉兰丹:KTN01
- 马六甲:MLK01
故障排除
常见问题
Claude无法连接到服务器
- 验证配置路径是否绝对且正确
- 检查 Claude 日志:
- 直接测试服务器:
没有可用的祈祷时间
- 验证互联网连接
- 检查区域代码是否有效(使用
list_zones
) - API 可能暂时不可用 - 请稍后重试
未找到城市
尝试使用不同的拼写、附近的大城市或适当的区域代码
贡献
欢迎贡献!贡献方式如下:
- 分叉存储库
- 创建功能分支:
git checkout -b feature/amazing-feature
- 提交您的更改:
git commit -m 'Add some amazing feature'
- 推送到分支:
git push origin feature/amazing-feature
- 打开拉取请求
开发设置
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。
致谢
- waktusolat.app - 用于提供祈祷时间数据 API
- 模型上下文协议- 适用于 MCP 框架
- JAKIM - 官方祈祷时间
- Claude Desktop - 用于人工智能集成平台
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
MCP 服务器可通过 Claude Desktop 访问马来西亚祈祷时间数据,使用户能够检索特定区域的祈祷时间、列出可用的祈祷区域并检查当前的祈祷时间状态。
Related MCP Servers
- -securityAlicense-qualityAn MCP server that allows checking local time on the client machine or current UTC time from an NTP serverLast updated -14PythonMIT License
- -securityAlicense-qualityA lightweight mcp server that tells you exactly what time is it based on your IP.Last updated -8PythonMIT License
- -security-license-qualityAn MCP server that enables Claude and other MCP clients to interact with Mattermost workspaces, providing channel management, messaging capabilities, and topic monitoring functionality.Last updated -TypeScript
- AsecurityAlicenseAqualityModel Context Protocol (MCP) server that provides weather forecast, warnings, water level associated with flood, and earthquake reports from Malaysia Government's Open API.Last updated -4PythonMIT License