Zmanim MCP服务器
用于计算犹太人祈祷时间的综合MCP服务器（zmanim）。
一个全面的模型上下文协议（MCP）服务器，用于使用python zmanim库计算犹太祈祷时间（zmanim）。
概述
此MCP服务器提供计算全球任何地点的各种犹太祈祷时间和天文时间的工具。它使用python zmanim库，这是KosherJava项目的python端口，实现了基于NOAA算法的精确天文计算。
特性
可用工具
- zmanim_get-sunrise_sunset -获取日出和日落时间
- zmanim_get_shema_times -获取早上背诵Shema的最新时间（GR“A和MG”A意见）
- zmanim_get-tefila_times -获取最新的晨祷时间/Shacharis（GR“A和MG”A意见）
- zmanim_get_mincha_时间 -获取下午祈祷的时间，包括Mincha Gedola、Mincha Ketana和Plag HaMincha
- zmanim_get_shabbat_时间 -获得安息日蜡烛照明和Havdalah时间
- zmanim_get-daily_times -获取一套全面的每日zmanim
主要特点
- ✅ 支持多种清真意见（GR“A，MG”A）
- ✅ 基于NOAA的精确天文计算
- ✅ 支持任何具有纬度/经度的全球位置
- ✅ 时区感知计算
- ✅ 可选日期规范（默认为今天）
- ✅ 多种输出格式（Markdown和JSON）
- ✅ 可定制的蜡烛照明偏移
- ✅ 全面的错误处理
安装
通过PyPI（推荐）
# For use with Claude Desktop or other MCP clients
uvx zmanim-mcp-serverClaude桌面配置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"zmanim": {
"command": "uvx",
"args": ["zmanim-mcp-server"]
}
}
}使用示例
获取日出和日落
Get sunrise and sunset times for New York City today:
- Location: New York, NY
- Latitude: 40.7128
- Longitude: -74.0060
- Time Zone: America/New_York获取最新Shema时间
What time is the latest I can say Shema in Jerusalem?
- Location: Jerusalem
- Latitude: 31.7683
- Longitude: 35.2137
- Time Zone: Asia/Jerusalem获取安息日时间
Get Shabbat candle lighting and Havdalah times for Chicago this Friday:
- Location: Chicago, IL
- Latitude: 41.8781
- Longitude: -87.6298
- Time Zone: America/Chicago
- Candle lighting offset: 18 minutes (can be customized)获取完整的每日日程表
Give me all the prayer times for London today:
- Location: London
- Latitude: 51.5074
- Longitude: -0.1278
- Time Zone: Europe/LondonZmanim解释
晨报
- 阿洛斯·哈沙查尔（黎明）日出前72分钟，第一缕阳光
- 日出（Hanetz HaChama）当太阳从地平线上升起时
- Sof Zman Krias Shema：最后一次背诵早上的Shema
- GR“A：日出后3小时 - MG“A：黎明后3小时（通常更早）
- 索夫·兹曼·特菲拉：晨祷的最后时间（Shacharis）
- GR“A：日出后4小时 - MG“A：黎明后4小时（通常更早）
下午时间
- Chatzos：太阳正午，日出和日落之间的中点
- Mincha Gedola下午祈祷的最早时间（中午后30分钟）
- Mincha Ketana：Mincha的首选最早时间（日落前2.5小时）
- 哈敏查海滩：日落前1.25小时（根据一些意见，最晚时间）
《晚间时报》
- 日落（Shkiah）当太阳落在地平线以下时
- Tzeis HaKochavim：夜幕降临，星星出现（日落后72分钟）
安息日和节假日
- 蜡烛照明：通常在日落前18-40分钟（因社区而异）
- 哈瓦拉安息日结束时，通常在Tzeis（日落后72分钟）
哈拉奇意见
服务器支持根据不同的清真机构进行计算：
- GR“A（维尔纳·高恩）：计算从日出到日落的天数
- MG“A（Magen Avraham）：计算从黎明（日出前72分钟）到黄昏的一天
响应格式
Markdown格式（默认）
人类可读的格式，具有清晰的标题和有组织的部分，非常适合显示。
JSON格式
机器可读的结构化数据，包括ISO 8601时间戳，适用于编程使用。
输入参数
所有工具都接受以下参数：
- 位置 （必填）：地点名称（例如“纽约，NY”）
- 纬度 （必填）：纬度以十进制表示（-90到90）
- 经度 （必填）：经度以十进制度数表示（-180至180）
- 时区 （必填）：IANA时区标识符（例如，“美洲/纽约”）
- 日期 （可选）：YYYY-MM-DD格式的日期（默认为今天）
- response_format （可选）：“markdown”或“json”（默认为markdown）
对于安息日时间，还有一个额外的参数：
- 烛光_偏移 （可选）：日落前几分钟（1-60，默认18）
技术细节
计算
- 使用NOAA（美国国家海洋和大气管理局）算法
- 考虑大气折射
- 使用IANA时区数据库感知时区
- 标高可以纳入计算中
依赖项
- 主控程序：模型上下文协议SDK
- Zmim：KosherJava zmanim库的Python移植
- 皮丹提克：输入验证和数据建模
常见位置示例
| 位置 | 纬度 | 经度 | 时区 |
|---|---|---|---|
| 耶路撒冷 | 1983年7月31日 | 2137年3月35日 | 亚洲/耶路撒冷 |
| 纽约 | 40.7128 | -74.0060 | 美国/纽约 |
| 洛杉矶 | 34.0522 | -118.2437 | 美国/洛杉矶_安吉利斯 |
| 伦敦 | 51.5074 | -0.1278 | 欧洲/伦敦 |
| 巴黎 | 48.8566 | 2.3522 | 欧洲/巴黎 |
| 悉尼 | -33.8688 | 151.2003 | 澳大利亚/悉尼 |
| 多伦多 | 43.6532 | -79.3832 | 美国/多伦多 |
| 迈阿密 | 2017年7月25日 | 2018年8月80日 | 美国/纽约 |
故障排除
服务器未出现在MCP客户端中
- 检查配置中的路径是否正确
- 确保Python和所有依赖项都已安装
- 验证配置文件语法是否为有效的JSON
- 配置更改后重新启动MCP客户端
时间显示为“N/A”
这通常发生在极地附近，在某些日子里太阳不会升起或落下。计算通过返回“N/A”来优雅地处理这个问题。
时区错误
确保您使用的是有效的IANA时区标识符。您可以在以下网址找到列表：https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
许可证
此MCP服务器使用python-zmanim库，该库根据从KosherJava项目移植的GNU较宽松通用公共许可证v2或更高版本（LGPLv2+）获得许可。
鸣谢
- 基于 python zmanim 拼音图书馆
- 原始Java库： KosherJava 作者：埃利亚胡·赫什菲尔德
- NOAA天文计算
支持
关于以下问题：
- 此MCP服务器：请打开一个问题，详细说明您的配置和问题
- Zmanim计算：请参阅 python-zmanim存储库
- 哈拉奇问题：咨询当地拉比或波塞克
未来的增强功能
需要考虑的潜在补充：
- 希伯来语日期计算
- 白天时间快
- 摩尔计算
- 假期决定
- 自定义意见配置
- 多日范围查询
- 导出为日历格式（iCal）
______________________________________________________________________
备注：此服务器仅供参考。对于实际的清真决定，请咨询合格的拉比。