Aladhan MCP Server

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-25

2.按坐标获取祈祷时间

获取特定地理坐标的伊斯兰祈祷时间。

参数：

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

5.获取计算方法

查看可用的伊斯兰祈祷时间计算方法。

例子：

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实时获取的。

故障排除

服务器未启动

1. 检查Python安装： python --version
2. 验证软件包是否已安装： pip list | grep mcp
3. 确保配置中的文件路径正确
4. 检查文件权限

API调用失败

• 检查您的互联网连接
• Aladhan API可能暂时不可用
• 几分钟后重试

缺少的依赖

安装所需的软件包：

pip install mcp requests

贡献

欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

开发设置

1. 克隆存储库
2. 创建虚拟环境： python -m venv venv
3. 激活它： source venv/bin/activate （Linux/Mac）或 venv\Scripts\activate （Windows）
4. 安装依赖项： pip install -r requirements.txt
5. 进行更改
6. 使用Claude Desktop进行测试

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• API阿拉丹 提供伊斯兰祈祷时间数据
• 模型上下文协议 通信标准
• 开源社区提供灵感和支持

支持

如果您遇到任何问题或有疑问：

1. 检查 问题 章节
2. 如果您的问题尚未报告，则创建新问题
3. 提供有关您的设置和错误的详细信息

______________________________________________________________________

注： 这是一个使用Aladhan API的非官方实现。请参阅他们的 服务条款 了解使用指南。