mcpField
S
Salaah MCP (Muslim Community Prayer Times)

Salaah MCP (Muslim Community Prayer Times)

本地服务
github.com/yusufk其他373 周前更新
代码仓库

关于 Salaah MCP (Muslim Community Prayer Times)

Salaah MCP 是面向需要伊斯兰礼拜及天文计算的个人和应用的 FastAPI 与 MCP 服务，可按地点和日期计算礼拜时间，并提供朝向、太阳、月亮及新月可见度信息。

主要功能

  1. 01按地点和日期计算礼拜时间
  2. 02选择所列计算方法
  3. 03返回朝向和距离
  4. 04提供太阳与月亮位置详情
  5. 05计算新月可见度

适用场景

  1. 01查询某地每日礼拜时间
  2. 02旅行时查找礼拜朝向
  3. 03查看太阳和月亮时间信息
  4. 04评估指定日期的新月可见度

MCP 相关

通过 MCP 服务向 MCP 客户端提供礼拜时间及相关计算功能。

#prayer-times#mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Salaah MCP（穆斯林社区礼拜时间）

一个基于 FastAPI 和 MCP 的服务，使用 islamic_times 库计算伊斯兰礼拜时间。

截图

依赖项

本项目依赖以下主要组件：

安装

  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 的访问地址：

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

获取任意地点朝向克尔白的方向和距离。

{
  "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

使用 Yallop 标准计算新月可见性。

{
  "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：世界穆斯林联盟
  • UMM_AL_QURA：麦加乌姆·古拉大学
  • EGYPTIAN：埃及测量总局
  • KARACHI：卡拉奇伊斯兰科学大学
  • TEHRAN：德黑兰大学地球物理研究所
  • JAFARI：库姆莱瓦研究所伊斯纳·阿什里派

Claude Desktop 集成

要在 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 Desktop 的配置目录中。

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

uv run run.py
  1. 启动 Claude Desktop，然后即可询问礼拜时间，例如：
  • “今天的晡礼是什么时候？”
  • “约翰内斯堡明天的晨礼是什么时候？”
  • “显示伦敦的所有礼拜时间”

AI 将使用 MCP 服务，根据你的查询计算准确的礼拜时间。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。