Salaah MCP

萨拉赫MCP（穆斯林社区祈祷时间）

一个使用FastAPI和MCP服务提供的伊斯兰祈祷时间计算 伊斯兰时代 库。

Screenshot

依赖项

这个项目依赖于以下主要依赖项：

• FastAPI用于构建API的Web框架
• FastAPI MCP模型控制协议
• 伊斯兰时报祈祷时间的核心计算引擎
• Pydantic：数据验证

安装

1. 克隆仓库：

git clone https://github.com/yourusername/salaah-mcp.git
cd salaah-mcp

1. 安装uvv及其依赖项：

pip install uv
uv install

用法

uv run run.py

API将可在以下地址访问：

• 开发环境：http://localhost:8000
• 生产环境：http://localhost:8000（可通过UVV_PORT环境变量配置）

API端点

计算祈祷时间

POST /prayer_times

根据给定的地点和日期计算祈祷时间。

示例请求：

{
  "latitude": -26.1528113,
  "longitude": 28.0049996,
  "method": "EGYPTIAN"
}

示例响应：

{
  "method": "Egyptian General Authority of Survey (Egypt)",
  "fajr": "2025-06-01T05:19:11.373053+02:00",
  "sunrise": "2025-06-01T06:47:44.369263+02:00",
  "zuhr": "2025-06-01T12:05:43.358460+02:00",
  "asr": "2025-06-01T15:23:52.560113+02:00",
  "sunset": "2025-06-01T17:23:52.560113+02:00",
  "maghrib": "2025-06-01T17:23:52.560113+02:00",
  "isha": "2025-06-01T18:43:09.341111+02:00",
  "midnight": "2025-06-02T00:06:02.228763+02:00"
}

获取朝向克尔白的方向

POST /qiblah

获取任何位置的朝向（Qiblah）方向和距离。

{
  "latitude": -26.1528113,
  "longitude": 28.0049996,
  "date": "2025-06-01T00:00:00Z"
}

示例响应：

{
  "distance_km": 5452,
  "distance_mi": 3388,
  "direction": "NNE",
  "angle_decimal": 14.647,
  "angle_dms": "014° 38′ 49.84″"
}

获取太阳信息

POST /sun

获取详细的太阳位置和时间信息。

示例回复：

{
  "sunrise": "2025-06-01T06:47:40",
  "transit": "2025-06-01T12:05:33",
  "sunset": "2025-06-01T17:23:36",
  "apparent_altitude": -42.659,
  "apparent_azimuth": 276.796,
  "distance_au": 1.014106,
  "apparent_declination": 22.166,
  "apparent_right_ascension": "04h 39m 56.17s",
  "greenwich_hour_angle": 99.904,
  "local_hour_angle": 127.951
}

获取月球信息

POST /moon

获取详细的月球位置和月相信息。

示例响应：

{
  "moonrise": "2025-06-01T11:39:22",
  "transit": "2025-06-01T16:25:15",
  "moonset": "2025-06-01T22:54:19",
  "illumination": 36.38,
  "apparent_altitude": 25.803,
  "azimuth": 305.203,
  "distance_km": 388391,
  "parallax": 0.941,
  "topocentric_declination": 15.892,
  "topocentric_right_ascension": "09h 52m 04.77s",
  "greenwich_hour_angle": 21.198,
  "local_hour_angle": 49.245
}

计算月球可见度

POST /moon/visibility

使用亚洛普标准计算新月的可见性。

{
  "latitude": -26.1528113,
  "longitude": 28.0049996,
  "date": "2025-05-27T00:00:00Z",
  "days": 3,
  "criterion": 1
}

示例回复：

[
  {
    "criterion": "Yallop",
    "date": "2025-05-27T15:28:52",
    "value": -0.788,
    "description": "F: Not visible; below the Danjon limit."
  },
  {
    "criterion": "Yallop",
    "date": "2025-05-28T15:56:44",
    "value": 0.958,
    "description": "A: Easily visible."
  }
]

可用的计算方法

• ISNA：北美伊斯兰教协会
• MWL：穆斯林世界联盟
• 乌姆阿尔古拉大学：麦加的乌姆阿尔古拉大学
• 埃及：埃及总测绘局
• 卡拉奇：卡拉奇伊斯兰科学大学
• 德黑兰：德黑兰大学地球物理研究所
• 贾法里：什叶派伊萨里派，莱瓦研究所在，库姆

克劳德桌面集成

要在Claude Desktop中使用祈祷时间服务：

1. 创建一个配置文件：

{
  "mcpServers": {
    "Salaah Times": {
      "command": "/Users/yusuf/.local/bin/mcp-proxy",
      "env": {
        "SSE_URL": "http://localhost:8000/mcp"
      }
    }
  }
}

1. 将此保存为 claude_desktop_config.json 在你的Claude桌面配置目录中。

1. 确保MCP服务正在运行：

uv run run.py

1. 启动Claude桌面版，现在您可以询问有关祈祷时间的问题，例如：

• 今天晡时祈祷是什么时间
• 约翰内斯堡明天的拂晓时间是什么时候
• “显示伦敦所有的祈祷时间”

人工智能将使用MCP服务，根据您的查询计算准确的祈祷时间。