Wasilah

Name: Wasilah
Author: mumullickm

远程服务

github.com/mumullickm其他01 周前更新

代码仓库

关于 Wasilah

Wasilah 是提供伊斯兰参考数据的远程 MCP 服务，适合查询礼拜时间及相关日历信息。它使用与 Wasilah 应用相同的天文引擎计算礼拜时间，且不调用外部 API。

主要功能

01每日礼拜时间与下一次礼拜
02朝向克尔白方位计算
03回历日期与月历
04古兰经章节音频链接
05真主尊名与赞念短语
06孟加拉国各区封斋与开斋偏移

适用场景

01按城市或坐标查询礼拜时间
02查询某地朝向克尔白的方向
03查找回历日期或月份
04获取古兰经音频及伊斯兰参考信息

MCP 相关

通过 MCP 工具向客户端（如 Claude）提供伊斯兰参考数据。地点、礼拜和日历计算在本地完成，不调用外部网络服务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://wasilah-mcp.aykiz.workers.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http mumullickm-wasilah https://wasilah-mcp.aykiz.workers.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"mumullickm-wasilah":{"type":"http","url":"https://wasilah-mcp.aykiz.workers.dev/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"mumullickm-wasilah":{"type":"http","url":"https://wasilah-mcp.aykiz.workers.dev/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"mumullickm-wasilah":{"type":"http","url":"https://wasilah-mcp.aykiz.workers.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"mumullickm-wasilah":{"serverUrl":"https://wasilah-mcp.aykiz.workers.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
asr	enum	否	晡礼的教法学派计算方法。“auto”会遵循计算方法对应地区的默认设置。auto \| shafii \| hanafi
city	string	否	要解析的城市名称，例如 "Dhaka" 或 "Madinah"。提供纬度和经度时会忽略此项。
date	string	否	日期，格式为 YYYY-MM-DD。默认为所在位置时区的今天。
method	enum	否	计算方法。默认为 "karachi"（应用默认值）。karachi \| isna \| mwl \| makkah \| egypt \| tehran \| gulf \| kuwait \| qatar \| singapore \| france \| turkey \| russia
latitude	number	否	纬度，单位为度，北纬为正。
timezone	string	否	IANA 时区，例如 "Asia/Dhaka"。与显式指定的纬度/经度配合使用。若省略，则根据最近的已知城市推断时区，并在答案中报告。
longitude	number	否	经度，单位为度，东经为正。
offset_minutes	object	否	可选的逐次礼拜时间调整值，以整分钟表示，与 Wasilah 应用中的偏移设置一致，例如 {"maghrib": 3}。仅应用于五次主命礼拜；日出时间不会调整。这些是用户自行设置的调整值，并非计算方法。
offset_minutes.asr	integer	否
offset_minutes.fajr	integer	否
offset_minutes.isha	integer	否
offset_minutes.dhuhr	integer	否
offset_minutes.maghrib	integer	否

详细介绍

Wasilah MCP

一个远程 Model Context Protocol 服务，可将 Wasilah 的伊斯兰参考数据作为自定义连接器提供给 Claude。在 Claude 中添加此 URL，即可直接询问礼拜时间、朝向克尔白、伊斯兰历日期和《古兰经》音频等问题。

礼拜时间使用与 Wasilah 应用相同的天文计算引擎计算（移植自 lib/features/prayer_times/prayer_astronomy.dart），因此对于相同的地点、日期、计算方法和教法学派，连接器和应用的结果精确到分钟且一致。

工具

工具	返回内容
`get_prayer_times`	某个城市或坐标的每日五番礼拜时间和日出时间。星期五会将晌礼标记为主麻礼拜。
`get_next_prayer`	下一次礼拜及剩余时间。
`get_qibla`	指向克尔白的指南针方位。
`get_hijri_date`	指定公历日期对应的伊斯兰历日期（乌姆·库拉历；不可用时回退到表格式历法）。
`get_hijri_calendar`	完整伊斯兰历月份对应的公历日期，以及该月的重要日期。
`get_quran_audio`	完整章节的流式诵读 URL，以及章节名称和经文数量。
`get_asma_ul_husna`	真主的 99 个尊名，包含阿拉伯语、转写、英语和孟加拉语。
`get_ifb_district_offset`	伊斯兰基金会孟加拉国公布的 64 个区相对于达卡的封斋前餐和开斋餐时间偏移。
`get_tasbeeh`	Wasilah 念珠计数器中的六段记主词，以及含义和惯用计数。

每个地点工具都接受 city 城市名称（通过内置离线数据库解析），或显式提供 latitude + longitude（可选提供 timezone；若省略，则根据最近的已知城市推断时区，并在回答中说明）。礼拜工具还接受 method（卡拉奇、ISNA、MWL、乌姆·库拉等）和 asr（auto、shafii、hanafi）。连接器不会进行任何外部网络调用。

本地运行

npm install
npm test        # exercises every tool through the MCP endpoint, no server needed
npm run dev     # serves the worker on http://localhost:8787

开发服务器运行后，将 MCP Inspector 指向 http://localhost:8787/mcp，即可浏览工具并进行交互式调用。

部署（Cloudflare Workers）

npx wrangler login
npm run deploy

Wrangler 会打印部署后的 URL，例如 https://wasilah-mcp.<subdomain>.workers.dev。连接器端点是在该 URL 后加上 /mcp。访问根 URL 会显示一个简短的落地页，其中包含连接器 URL 和设置步骤。

添加到 Claude

进入 Settings，然后选择 Connectors。
添加自定义连接器。
粘贴 https://<your-worker-url>/mcp。
询问类似“今天达卡的昏礼时间是几点？”或“从麦地那朝哪个方向是克尔白？”

此服务无需身份验证且为无状态服务。它只提供公开参考数据，不保存任何个人信息，也无需登录。

说明

礼拜时间一致性。 计算方法的角度、晡礼的影长系数和太阳几何计算均与应用完全一致。应用的默认设置是卡拉奇计算法和哈乃斐晡礼。
伊斯兰历来源。 当运行时的 ICU 支持时使用乌姆·库拉历，否则使用表格式计算。表格式日期可能与观月公告相差一天。
完全离线。 连接器不会调用任何外部 API。城市查询使用内置离线数据库（GeoNames 的一个子集，采用 CC BY 4.0 许可：每个国家的主要城市以及所有首都）；礼拜时间、朝向克尔白和伊斯兰历日期均由服务端计算。数据库中没有的地点可直接传入坐标。
不处理个人数据。 此服务不会接触设备上的 Salah 追踪器。若要提供每位用户的历史记录，则需要带账户和 OAuth 的 Wasilah 后端。