Aladhan MCP服务器
一个模型上下文协议（MCP）服务器，使用 API阿拉丹.
特性
- 🕌 祷告时间：获取任何城市或坐标的准确伊斯兰祈祷时间
- 📅 日期转换：转换公历和回历（伊斯兰）
- 🧭 基布拉 方向：从任何地方找到去麦加的方向
- ⚙️ 计算方法：查看不同的祈祷时间计算方法
- 🌍 全球覆盖：在全球范围内使用Aladhan API
- 📱 多种格式：支持城市名称和GPS坐标
安装
先决条件
- Python 3.8或更高版本
- Claude桌面应用程序
再进行
pip install -r requirements.txt或手动安装：
pip install mcp requests配置
适用于克劳德桌面
将此添加到您的Claude Desktop配置文件中：
窗户： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"aladhan-api": {
"command": "python",
"args": ["/path/to/aladhan_mcp_server.py"]
}
}
}替换 /path/to/aladhan_mcp_server.py 以及服务器文件的实际路径。
对于其他MCP客户端
服务器可以直接运行：
python aladhan_mcp_server.py可用工具
1.按城市统计祈祷时间
获取特定城市和日期的伊斯兰祈祷时间。
参数：
city（必填）：城市名称country（必填）：国家名称date（可选）：YYYY-MM-DD格式的日期（默认为今天）method（可选）：计算方法ID（1-15）school（可选）：Asr法律方法（Shafi为0，Hanafi为1）
例子：
Get prayer times for London, UK today
Get prayer times for Cairo, Egypt for 2024-12-252.按坐标获取祈祷时间
获取特定地理坐标的伊斯兰祈祷时间。
参数：
latitude（必填）：位置的纬度longitude（必填）：位置经度date（可选）：YYYY-MM-DD格式的日期（默认为今天）method（可选）：计算方法ID（1-15）school（可选）：Asr法律方法（Shafi为0，Hanafi为1）
例子：
Get prayer times for coordinates 40.7128, -74.0060
What are the prayer times for latitude 21.4225, longitude 39.8262?3.将公历日期转换为回历日期
将公历日期转换为伊斯兰（回历）日历。
参数：
date（必填）：公历日期，格式为DD-MM-YYYY
例子：
Convert 25-12-2024 to Hijri date
What is 01-01-2025 in the Islamic calendar?4.获取七卜拉方向
从任何位置找到朝拜方向（朝向麦加）。
参数：
latitude（必填）：位置的纬度longitude（必填）：位置经度
例子：
What is the Qibla direction for coordinates 40.7128, -74.0060?
Show me Qibla direction for New York City coordinates5.获取计算方法
查看可用的伊斯兰祈祷时间计算方法。
例子：
Show me available prayer time calculation methods
What calculation methods are available for prayer times?支持的计算方法
服务器支持各种伊斯兰祈祷时间计算方法，包括：
- 方法1卡拉奇伊斯兰科学大学
- 方法2：北美伊斯兰协会
- 方法3：世界穆斯林联盟（MWL）
- 方法4：麦加乌姆库拉大学
- 方法5：埃及勘测总局
- 还有更多。..
使用 get_calculation_methods 工具查看包含参数的完整列表。
api参考
此服务器使用 API阿拉丹 提供准确的伊斯兰祈祷时间和相关信息。所有数据都是从它们的公共API实时获取的。
故障排除
服务器未启动
- 检查Python安装：
python --version - 验证软件包是否已安装：
pip list | grep mcp - 确保配置中的文件路径正确
- 检查文件权限
API调用失败
- 检查您的互联网连接
- Aladhan API可能暂时不可用
- 几分钟后重试
缺少的依赖
安装所需的软件包：
pip install mcp requests贡献
欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
开发设置
- 克隆存储库
- 创建虚拟环境：
python -m venv venv - 激活它：
source venv/bin/activate（Linux/Mac）或venv\Scripts\activate（Windows） - 安装依赖项：
pip install -r requirements.txt - 进行更改
- 使用Claude Desktop进行测试
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
致谢
支持
如果您遇到任何问题或有疑问：
- 检查 问题 章节
- 如果您的问题尚未报告，则创建新问题
- 提供有关您的设置和错误的详细信息
______________________________________________________________________
注： 这是一个使用Aladhan API的非官方实现。请参阅他们的 服务条款 了解使用指南。