Zmanim MCP Server

🚀 Zmanim MCP Server

Zmanim MCP Server是一個全面的MCP服務器，用於計算猶太祈禱時間（zmanim）。它藉助python - zmanim庫，能夠為全球任意地點計算各類猶太祈禱時間和天文時間。

🚀 快速開始

此MCP服務器提供了計算世界各地猶太祈禱時間和天文時間的工具。它利用python - zmanim庫（KosherJava項目的Python移植版本），基於NOAA算法實現精確的天文計算。

✨ 主要特性

可用工具

1. zmanim_get_sunrise_sunset - 獲取日出和日落時間
2. zmanim_get_shema_times - 獲取晨禱經文（Shema）的最晚誦讀時間（依據GR"A和MG"A觀點）
3. zmanim_get_tefila_times - 獲取晨禱（Shacharis）的最晚時間（依據GR"A和MG"A觀點）
4. zmanim_get_mincha_times - 獲取下午祈禱時間，包括大祈禱時間（Mincha Gedola）、小祈禱時間（Mincha Ketana）和祈禱間隔時間（Plag HaMincha）
5. zmanim_get_shabbat_times - 獲取安息日蠟燭點燃和哈夫達拉（Havdalah）時間
6. zmanim_get_daily_times - 獲取所有每日祈禱時間的綜合信息

關鍵特性

• ✅ 支持多種猶太律法觀點（GR"A、MG"A）
• ✅ 基於NOAA的精確天文計算
• ✅ 支持任意經緯度的全球地點
• ✅ 支持時區感知計算
• ✅ 可選日期指定（默認今天）
• ✅ 多種輸出格式（Markdown和JSON）
• ✅ 可自定義蠟燭點燃時間偏移量
• ✅ 全面的錯誤處理

📦 安裝指南

通過PyPI（推薦）

# 用於Claude Desktop或其他MCP客戶端
uvx zmanim-mcp-server

Claude Desktop配置

添加到claude_desktop_config.json：

{
  "mcpServers": {
    "zmanim": {
      "command": "uvx",
      "args": ["zmanim-mcp-server"]
    }
  }
}

💻 使用示例

基礎用法

獲取日出和日落時間

獲取紐約市今天的日出和日落時間：
- 地點：紐約，紐約州
- 緯度：40.7128
- 經度：-74.0060
- 時區：America/New_York

獲取晨禱經文（Shema）的最晚誦讀時間

在耶路撒冷，我最晚什麼時候可以誦讀晨禱經文（Shema）？
- 地點：耶路撒冷
- 緯度：31.7683
- 經度：35.2137
- 時區：Asia/Jerusalem

獲取安息日時間

獲取芝加哥本週五的安息日蠟燭點燃和哈夫達拉（Havdalah）時間：
- 地點：芝加哥，伊利諾伊州
- 緯度：41.8781
- 經度：-87.6298
- 時區：America/Chicago
- 蠟燭點燃時間偏移量：18分鐘（可自定義）

獲取完整的每日祈禱時間表

給我倫敦今天的所有祈禱時間：
- 地點：倫敦
- 緯度：51.5074
- 經度：-0.1278
- 時區：Europe/London

📚 詳細文檔

猶太祈禱時間解釋

早晨時間

• Alos HaShachar（黎明）：日出前72分鐘的第一縷光線
• Sunrise（Hanetz HaChama）：太陽昇起在地平線之上的時間
• Sof Zman Krias Shema：晨禱經文（Shema）的最晚誦讀時間
  • GR"A：日出後3小時
  • MG"A：從黎明（日出前72分鐘）起3個臨時小時（通常更早）
• Sof Zman Tefila：晨禱（Shacharis）的最晚時間
  • GR"A：日出後4小時
  • MG"A：從黎明起4個臨時小時（通常更早）

下午時間

• Chatzos：太陽正午，日出和日落的中點
• Mincha Gedola：下午祈禱的最早時間（中午後30分鐘）
• Mincha Ketana：下午祈禱的首選最早時間（日落前2.5小時）
• Plag HaMincha：日落前1.25小時（某些觀點認為的最晚時間）

晚上時間

• Sunset（Shkiah）：太陽落下地平線以下的時間
• Tzeis HaKochavim：夜幕降臨，星星出現的時間（日落後72分鐘）

安息日和節日

• Candle Lighting：通常在日落前18 - 40分鐘（因社區而異）
• Havdalah：安息日結束的時間，通常在夜幕降臨（日落後72分鐘）

猶太律法觀點

服務器支持根據不同猶太律法權威進行計算：

• GR"A（維爾納加昂）：從日出到日落計算一天
• MG"A（馬根·亞伯拉罕）：從黎明（日出前72分鐘）到夜幕降臨計算一天

響應格式

Markdown格式（默認）

具有清晰標題和有序章節的人類可讀格式，非常適合展示。

JSON格式

包含ISO 8601時間戳的機器可讀結構化數據，適用於編程使用。

輸入參數

所有工具接受以下參數：

• location（必需）：地點名稱（例如，"紐約，紐約州"）
• latitude（必需）：十進制緯度（-90到90）
• longitude（必需）：十進制經度（-180到180）
• time_zone（必需）：IANA時區標識符（例如，"America/New_York"）
• date（可選）：YYYY - MM - DD格式的日期（默認今天）
• response_format（可選）："markdown"或"json"（默認markdown）

對於安息日時間，還有一個額外參數：

• candle_lighting_offset（可選）：日落前的分鐘數（1 - 60，默認18）

🔧 技術細節

計算方式

• 使用NOAA（美國國家海洋和大氣管理局）算法
• 考慮大氣折射
• 使用IANA時區數據庫進行時區感知計算
• 計算中可納入海拔信息

依賴項

• mcp：模型上下文協議SDK
• zmanim：KosherJava zmanim庫的Python移植版本
• pydantic：輸入驗證和數據建模

📚 常見地點示例

📚 故障排除

服務器未在MCP客戶端中顯示

1. 檢查配置中的路徑是否正確
2. 確保Python和所有依賴項已安裝
3. 驗證配置文件語法是否為有效的JSON
4. 配置更改後重啟MCP客戶端

時間顯示為"N/A"

這種情況通常發生在極地附近的地點，某些日子太陽不會升起或落下。計算會優雅地返回"N/A"。

時區錯誤

確保使用有效的IANA時區標識符。你可以在以下鏈接找到列表：https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

📄 許可證

此MCP服務器使用python - zmanim庫，該庫根據GNU Lesser General Public License v2或更高版本（LGPLv2 +）許可，源自KosherJava項目。

📚 致謝

• 基於pinnymz的python - zmanim庫
• 原始Java庫：Eliyahu Hershfeld的KosherJava
• NOAA天文計算

📚 支持

此MCP服務器相關問題

請詳細說明配置和問題並提交問題報告。

猶太祈禱時間計算問題

請參考python - zmanim倉庫。

猶太律法問題

請諮詢當地拉比或律法專家。

📚 未來增強功能

可考慮的潛在新增功能：

• 希伯來日期計算
• 齋戒日時間
• 新月計算
• 節日確定
• 自定義觀點配置
• 多日範圍查詢
• 導出到日曆格式（iCal）

⚠️ 重要提示

此服務器僅用於信息參考。如需實際的猶太律法決策，請諮詢合格的拉比。