Zmanim MCP Server

Zmanim MCP サーバー

ユダヤ教の祈りの時刻（zmanim）を計算する包括的な MCP サーバーです。

python-zmanim ライブラリを使用して、ユダヤ教の祈りの時刻（zmanim）を計算する包括的な Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは、世界中のあらゆる場所について、さまざまなユダヤ教の祈りの時刻と天文時刻を計算するツールを提供します。KosherJava プロジェクトを Python に移植した python-zmanim ライブラリを使用しており、NOAA アルゴリズムに基づく正確な天文計算を実行します。

機能

利用可能なツール

1. zmanim_get_sunrise_sunset - 日の出と日の入りの時刻を取得します
2. zmanim_get_shema_times - 朝のシェマ朗読の最終時刻を取得します（GR"A および MG"A の見解）
3. zmanim_get_tefila_times - 朝の祈り／シャハリートの最終時刻を取得します（GR"A および MG"A の見解）
4. zmanim_get_mincha_times - ミンハー・ゲドーラー、ミンハー・ケタナー、プラグ・ハミンハーを含む午後の祈りの時刻を取得します
5. zmanim_get_shabbat_times - 安息日のろうそく点灯時刻とハヴダラーの時刻を取得します
6. 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-server

Claude Desktop の設定

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

シェマの最終時刻を取得

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)

1日のスケジュール全体を取得

Give me all the prayer times for London today:
- Location: London
- Latitude: 51.5074
- Longitude: -0.1278
- Time Zone: Europe/London

Zmanim の解説

朝の時刻

• Alos HaShachar（夜明け）：最初の光。日の出の72分前です
• 日の出（Hanetz HaChama）：太陽が地平線の上に昇る時刻です
• Sof Zman Krias Shema：朝のシェマを朗読できる最終時刻です
  • GR"A：日の出から3時間後です
  • MG"A：夜明けからの相対時刻で3時間（通常はより早い時刻）です
• Sof Zman Tefila：朝の祈り（シャハリート）の最終時刻です
  • GR"A：日の出から4時間後です
  • MG"A：夜明けからの相対時刻で4時間（通常はより早い時刻）です

午後の時刻

• Chatzos：太陽正午。日の出と日の入りの中間時刻です
• Mincha Gedola：午後の祈りを始められる最も早い時刻（正午から30分後）です
• Mincha Ketana：ミンハーに適した最も早い時刻（日の入りの2.5時間前）です
• Plag HaMincha：日の入りの1.25時間前（一部の見解における最終時刻）です

夜の時刻

• 日の入り（Shkiah）：太陽が地平線の下に沈む時刻です
• Tzeis HaKochavim：星が見え始める夜の訪れの時刻（日の入りの72分後）です

安息日と祝日

• ろうそく点灯：通常、日の入りの18～40分前です（地域によって異なります）
• ハヴダラー：安息日が終わる時刻。通常は Tzeis（日の入りの72分後）です

ハラハー上の見解

このサーバーは、異なるハラハーの権威に基づく計算に対応しています。

• GR"A（ヴィルナのガオン）：日の出から日没までを一日として計算します
• MG"A（マゲン・アブラハム）：夜明け（日の出の72分前）から夜までを一日として計算します

レスポンス形式

Markdown 形式（デフォルト）

明確な見出しと整理されたセクションを備えた、人が読みやすい形式です。表示に適しています。

JSON 形式

ISO 8601 タイムスタンプを含む、プログラムでの利用に適した機械可読の構造化データです。

入力パラメーター

すべてのツールで、次のパラメーターを受け付けます。

• location（必須）：場所の名前（例："New York, NY"）
• latitude（必須）：10進数表記の緯度（-90～90）
• longitude（必須）：10進数表記の経度（-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 タイムゾーンデータベースを使用して、タイムゾーンを考慮します
• 計算に標高を組み込むことができます

依存関係

• fastmcp：スタンドアロンの FastMCP フレームワーク
• zmanim：KosherJava zmanim ライブラリの Python 移植版
• pydantic：入力検証とデータモデリング

一般的な場所の例

場所	緯度	経度	タイムゾーン
エルサレム	31.7683	35.2137	Asia/Jerusalem
ニューヨーク	40.7128	-74.0060	America/New_York
ロサンゼルス	34.0522	-118.2437	America/Los_Angeles
ロンドン	51.5074	-0.1278	Europe/London
パリ	48.8566	2.3522	Europe/Paris
シドニー	-33.8688	151.2093	Australia/Sydney
トロント	43.6532	-79.3832	America/Toronto
マイアミ	25.7617	-80.1918	America/New_York

トラブルシューティング

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 サーバーは、GNU Lesser General Public License v2 or later（LGPLv2+）でライセンスされ、KosherJava プロジェクトから移植された python-zmanim ライブラリを使用しています。

クレジット

• pinnymz による python-zmanim ライブラリを基にしています
• 元の Java ライブラリ：KosherJava（Eliyahu Hershfeld 作）
• NOAA の天文計算

サポート

次の内容に関する問題について：

• この MCP サーバー：設定と問題の詳細を添えて、イシューを作成してください
• Zmanim の計算：python-zmanim リポジトリを参照してください
• ハラハーに関する質問：地域のラビまたはポーセークにご相談ください

今後の機能強化

追加を検討できる機能：

• ヘブライ暦の日付計算
• 断食日の時刻
• モラードの計算
• 祝日の判定
• 見解のカスタム設定
• 複数日にわたる範囲のクエリ
• カレンダー形式（iCal）へのエクスポート

---

注：このサーバーは情報提供を目的としています。実際のハラハー上の判断については、資格を持つラビにご相談ください。