Muslim Prayer Reminder MCP

Muslim Prayer Reminder MCP

AI ワークフロー内で礼拝時刻とリマインダーを確認できます。
ChatGPT、Claude、Cursor、その他の MCP クライアントで、地域の礼拝時刻を確認し、次の礼拝を把握して、リマインダーを設定できます。

ChatGPT で開く  ·  ドキュメント  ·  クイックスタート  ·  ツール一覧  ·  デモを見る

🕌 ローンチ週間 · 26 Oct – 1 Nov 2026： Muslim Prayer Reminder MCP が HalaLaunch で公開されました
実際の 1080p デモを見る · ChatGPT で試す

_{積極的にメンテナンス中 · Cloudflare Workers · Ubuntu と Windows 上の Node.js 22/24
開発：Smart Creations · メンテナー：Tareq Naji}

地域の礼拝時刻	次の礼拝をすぐに確認	お好みのセットアップ
12 種類の計算方法に対応した、位置情報に基づく時刻表。	次の礼拝までのカウントダウンと、設定可能なリマインダー時間帯。	ホスト済みエンドポイントに接続するか、stdio 経由でローカル実行できます。

---

⚡ クイックスタート

1. NPX で実行（インストール不要）

Claude Desktop または Cursor の MCP 設定に追加します：

{
  "mcpServers": {
    "muslim-prayer": {
      "command": "npx",
      "args": ["-y", "muslim-prayer-mcp"]
    }
  }
}

2. リモート Streamable HTTP で接続（Cloudflare Workers）

{
  "mcpServers": {
    "muslim-prayer": {
      "url": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

3. Cursor にワンクリックでインストール

---

アナリティクスダッシュボード

/analytics には、最小構成の SQLite Durable Object から、日次、週次、月次、および選択した期間のアクティブユーザー数が表示されます。検証済みの OpenAI の送信元 IP を経由してアクセスした、識別可能な ChatGPT ツールユーザーのみを集計します。個々のツール呼び出し、ハンドシェイク、セッション、IP、ボットの活動、位置情報の詳細は記録しません。 ANALYTICS_TOKEN または AUTH_TOKEN が設定されていない場合、ダッシュボードは公開されます。

• 保護するには： ANALYTICS_TOKEN という名前の Worker シークレットを設定します（Cloudflare ダッシュボード、Worker、Settings、Variables and Secrets）。/analytics を開き、トークンをパスワードとして、任意のユーザー名を入力します。/api/analytics では Authorization: Bearer <token> も使用できます。
• データモデル： UTC の日ごとに、検証済みの ChatGPT subject ごとに 1 行を記録し、公開プレフィックス mpr:v1: を付けた 64 ビットに切り詰めた SHA-256 仮名を使用します。呼び出し単位のアナリティクスは保持されず、アクティビティは最大 180 日間保持されます。
• クォータのガードレール： UTC の 1 日あたり、追跡対象の異なるユーザーは最大 500 人です。レポートには 4 つの固定期間（7／30／90／180 日）があり、各期間につき UTC の 1 日あたり永続化されるスナップショットは最大 1 件です。上限に達すると、それ以降のユーザー日数は集計されませんが、礼拝ツールは引き続き利用できます。
• 検証と制限： subject と OpenAI の IP 範囲のチェックは慎重な判定基準であり、人間であることの証明ではありません。ChatGPT 以外のユーザー、subject ID がない場合、ツール呼び出しのないインストール、検証可能な情報源がないクライアントは集計されません。Cloudflare アカウントの残りの無料クォータを確保できる Worker レベルの方式はありません。

📺 ライブ動画デモ

ChatGPT、Claude、Cursor 内で Muslim Prayer Reminder MCP が動作する様子をご覧ください。

👉 こちらをクリックして、1080p のフルデモ動画（MP4）をご覧ください

---

🏛️ システムアーキテクチャ

flowchart TD
    subgraph ClientLayer ["AI Clients & Environments"]
        Cursor["Cursor IDE"]
        Claude["Claude Desktop / Web"]
        ChatGPT["ChatGPT Apps Directory"]
        Agent["Autonomous AI Agent"]
    end

    subgraph TransportLayer ["Model Context Protocol"]
        HTTP["Streamable HTTP /mcp"]
        Stdio["Stdio Transport CLI"]
    end

    subgraph ResolverLayer ["Layered Location Resolver"]
        Explicit["User coordinates + timezone or supported city"] --> Truncate["2-Decimal Sanitizer ~1.1km"]
        UserPref["Stored KV Preferences"] --> Resolver["Location Normalizer"]
        Headers["Verified end-user location headers"] --> Resolver
        Resolver --> Missing["No usable user location: location_required"]
        Truncate --> Resolver
    end

    GeoIP["Cloudflare network metadata"] --> Analytics["Operational analytics only"]

    subgraph EngineLayer ["In-Isolate Solar Calculation Engine"]
        Resolver --> Authority["Authority Selector"]
        Authority --> AdhanEngine["Astronomical Solar Solver"]
        AdhanEngine --> FiqhRules["Fiqh Clamping 48° & Madhab Calibration"]
        FiqhRules --> DueLogic["Prayer Window & Due Evaluator"]
    end

    subgraph OutputLayer ["Formatted Payloads & Disclosures"]
        DueLogic --> MCPResponse["JSON-RPC Structured Output"]
        MCPResponse --> DisclosureNotice["Mandatory Theological Notice"]
        DisclosureNotice --> Middleware["Deterministic Host Middleware"]
        Middleware --> FinalOutput["Appended AI Response: 🕌 It is time for Maghrib prayer"]
    end

    ClientLayer --> TransportLayer
    TransportLayer --> ResolverLayer

---

MCP プロンプトとリソース

5 つの計算・設定ツールに加えて、互換性のある MCP クライアントは、プロトコルネイティブの読み取り専用学習機能を 2 つ利用できます。

• プロンプト： check_prayer_times_with_disclosure は、クライアントがツールを使って実際の礼拝時刻を取得し、不足している位置情報を尋ね、計算の権威、選択理由、高緯度地域向けの調整について説明できるようにします。
• リソース： prayer://calculation-guide は、位置情報の要件、Asr の規則、薄明の計算方法、地域のモスクの礼拝時刻表との違いを簡潔に説明します。

これらの機能が礼拝時刻を推測したり、非公開の設定を読み取ったり、計算ツールの代わりになったりすることはありません。現在ホストされている MCP エンドポイントから利用できます。古いローカルの npm バージョンでは、更新するまで新しいプロンプトとリソースが利用できない場合があります。

---

🛠️ MCP ツールカタログ

サーバーは、最新の Model Context Protocol 標準に準拠した、Zod の完全な出力コントラクトを備える、細かく調整された 5 つのツールを公開します。

ツール名	操作モード	オープンワールド	説明
get_prayer_status	一時的な状態の書き込み	安全	義務の礼拝の時間が現在来ているかを確認します。現在の礼拝、カウントダウン、計算方式の権威、および選択の根拠を返します。
get_today_prayer_times	読み取り専用	安全	今日の全礼拝時刻表（Fajr、Sunrise、Dhuhr、Asr、Maghrib、Isha）を UTC とローカライズされた文字列形式で計算します。
get_next_prayer	読み取り専用	安全	次に予定されている礼拝、正確な予定時刻、カウントダウンの分数、および地域の権威を返します。
configure_prayer_preferences	保存済み設定を上書き（destructiveHint: true）	安全	指定された設定を更新します。固定位置に切り替えると、以前の位置とタイムゾーンがクリアされる場合があります。元に戻すための以前の値は保持されません。
get_prayer_preferences	読み取り専用	安全	保存済みの公開設定を読み取ります。

---

📐 天文学的・神学的な厳密性

礼拝の計算には天文学モデルと設定された地域方式を使用します。高緯度地域での代替手法や地理的なヒューリスティックについては明示します。

権威機関	管轄地域	Fajr の角度	Isha の角度／間隔	Asr の既定マズハブ
Umm al-Qura University	サウジアラビア	18.5°	+90 min	シャーフィイー派／標準
Egyptian General Survey	エジプト、パレスチナ、レバント	19.5°	17.5°	シャーフィイー派（設定済みのパレスチナ向け時刻補正を適用）
Diyanet İşleri Başkanlığı	トルコ、バルカン半島、中央アジア	18.0°	17.0°	ハナフィー派（二重影の比率）
Univ. of Islamic Sciences, Karachi	パキスタン、インド、バングラデシュ	18.0°	18.0°	ハナフィー派（二重影の比率）
ISNA	米国、カナダ	15.0°	15.0°	シャーフィイー派／標準
Muslim World League (MWL)	ヨーロッパ、全世界のフォールバック	18.0°	17.0°	シャーフィイー派／標準
Configured Singapore method	マレーシア、シンガポール、インドネシア	20.0°	18.0°	シャーフィイー派／標準

高緯度・極地での補正

夏季に薄明が夜通し続く北緯または南緯 48°を超える地域では、計算エンジンがフィクフに準拠した制限処理（夜の中間と7 分の 1 ルール）を自動的に適用し、計算エラーや実現不可能な時刻表を防ぎます。

---

🔌 インストールとマルチエージェントのセットアップ

Muslim Prayer Reminder を任意の AI エージェントハーネス、開発者向け IDE、またはコンテナーランタイムに接続できます。

ワンクリックと対応環境一覧

環境／ハーネス	プロトコルモード	クイックコマンド／ディープリンク
Cursor IDE	リモート HTTP
Claude Code	ネイティブプラグイン	/plugin marketplace add tareq7/muslim-prayer-mcp
Codex	ネイティブプラグイン	codex plugin marketplace add tareq7/muslim-prayer-mcp
GitHub Copilot CLI	Copilot プラグイン	copilot plugin marketplace add tareq7/muslim-prayer-mcp
Claude Desktop	Stdio CLI	claude_desktop_config.json 経由で npx -y muslim-prayer-mcp
VS Code & Cline	ローカル NPX	.vscode/mcp.json 経由で npx -y muslim-prayer-mcp
Windsurf & Devin	リモート HTTP	mcp_config.json にリモート URL を指定
Gemini CLI	ネイティブ拡張機能	gemini mcp add --transport http muslim-prayer https://muslim-prayer-mcp.najetareqz.workers.dev/mcp
Pi Agent Harness	Git 拡張機能	pi install git:github.com/tareq7/muslim-prayer-mcp
OpenCode	エージェントプラグイン	opencode.json と AGENTS.md 経由で自動読み込み
Docker Container	コンテナー	docker build -t muslim-prayer-mcp . の後に docker run --rm -i muslim-prayer-mcp（stdio）を実行

---

Claude Code

Claude Code セッション内で実行します：

/plugin marketplace add tareq7/muslim-prayer-mcp
/plugin install muslim-prayer-mcp@muslim-prayer-mcp

（注：2つのプロンプトに分けて送信してください）。Claude Code Desktop app で、プロンプトボックスの横にある + ボタンをクリックし、Plugins ➔ Add plugin の順に選択すると、マーケットプレイスから参照してインストールできます。

---

Codex

ターミナルで実行します：

codex plugin marketplace add tareq7/muslim-prayer-mcp
codex plugin add muslim-prayer-mcp@muslim-prayer-mcp

codex を実行して /hooks を開きます（または新しいスレッドを開始します）。再起動すると、Codex Desktop app でもプラグインが有効になります。

---

GitHub Copilot CLI

ターミナルで実行します：

copilot plugin marketplace add tareq7/muslim-prayer-mcp
copilot plugin install muslim-prayer-mcp@muslim-prayer-mcp

または、Copilot CLI の対話型セッション内で実行します：

/plugin marketplace add tareq7/muslim-prayer-mcp
/plugin install muslim-prayer-mcp@muslim-prayer-mcp

---

Cursor IDE

クリックしてワンクリックでインストールします：

または、.cursor/mcp.json に手動で追加します：

{
  "mcpServers": {
    "muslim-prayer": {
      "url": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

---

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "muslim-prayer": {
      "command": "npx",
      "args": ["-y", "muslim-prayer-mcp"]
    }
  }
}

---

VS Code & Cline

VS Code の servers 形式を使用して、.vscode/mcp.json に追加します：

{
  "servers": {
    "muslim-prayer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "muslim-prayer-mcp"]
    }
  }
}

Cline の設定では、Quick Start に記載されている mcpServers 形式を使用します。

---

Windsurf & Devin

mcp_config.json に追加します：

{
  "mcpServers": {
    "muslim-prayer": {
      "url": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

---

Gemini CLI

ライブエッジエンドポイントを使用して直接接続します：

gemini mcp add --transport http muslim-prayer https://muslim-prayer-mcp.najetareqz.workers.dev/mcp

---

Pi Agent Harness

pi install git:github.com/tareq7/muslim-prayer-mcp

---

OpenCode

opencode.json に追加します：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "muslim-prayer": {
      "type": "remote",
      "url": "https://muslim-prayer-mcp.najetareqz.workers.dev/mcp"
    }
  }
}

OpenCode は、このリポジトリの AGENTS.md と skills/muslim-prayer-mcp/SKILL.md を自動的に読み込みます。

---

Docker Container

docker build -t muslim-prayer-mcp .
docker run --rm -i muslim-prayer-mcp

---

💻 決定論的ホストミドルウェア

自律型 AI エージェントを構築するプラットフォーム（Next.js、LangChain、Vercel AI SDK）向けに、付属のミドルウェアはハルシネーションを起こすことなく、祈りに関する通知を AI の応答に決定論的に追加します：

import { PrayerReminderMiddleware } from 'muslim-prayer-mcp/middleware';

const prayerMiddleware = new PrayerReminderMiddleware({
  workerBaseUrl: 'https://muslim-prayer-mcp.najetareqz.workers.dev',
  userId: 'user_session_42',
});

// Wrap any LLM completion
const rawLlmOutput = await callLlm('Can you review this pull request?');
const { responseText, reminderAppended } = await prayerMiddleware.processResponse(rawLlmOutput, {
  'X-User-Coordinates': '24.71, 46.68', // Riyadh
  'X-User-Timezone': 'Asia/Riyadh',
});

console.log(responseText);
// => The code looks solid, but let's optimize line 42...
//
// 🕌 It is time for Asr prayer.

---

🧪 包括的なテストスイート

このエンジンには、世界各地の10か所のベンチマーク座標における天文学的な精度を検証する、ユニットテスト、統合テスト、エンドツーエンドテストが44件含まれています：

npm test

▶ Astronomical Prayer Calculation Suite
  ✔ calculates valid prayer timetable for Riyadh in correct chronological sequence
  ✔ calculates valid prayer timetable for Makkah in correct chronological sequence
  ✔ calculates valid prayer timetable for Cairo in correct chronological sequence
  ✔ calculates valid prayer timetable for Dubai in correct chronological sequence
  ✔ calculates valid prayer timetable for London in correct chronological sequence
  ✔ calculates valid prayer timetable for Paris in correct chronological sequence
  ✔ calculates valid prayer timetable for New York in correct chronological sequence
  ✔ calculates valid prayer timetable for Jakarta in correct chronological sequence
  ✔ calculates valid prayer timetable for Karachi in correct chronological sequence
  ✔ calculates valid prayer timetable for Sydney (Southern Hem) in correct chronological sequence
  ✔ verifies Hanafi Asr is strictly later than Shafi Asr
  ✔ handles Daylight Saving Time (DST) transitions safely
  ✔ automatically resolves Palestinian Awqaf standard for Gaza
  ✔ handles high-latitude polar city with MiddleOfTheNight rule safely
...
ℹ tests 44 | pass 44 | fail 0

---

🔒 セキュリティとプライバシーポリシー

• 座標の切り捨て：ユーザーの座標はすべて、受信時に小数点以下2桁に切り捨てられます（解像度は約1.1 km）。正確な位置を数学的に復元することはできません。
• 外部への追跡なし：天文学的な計算は分離された V8 ランタイム内でローカルに行われます。サードパーティの追跡 API への外部リクエストは一切ありません。
• フェイルオープン設計：ホストミドルウェアはフェイルオープンするように設計されており、ネットワークの問題や遅延の急増によって、主要な AI の会話ストリームがブロックされることはありません。
• 完全な開示プロセス：サポート対象バージョン、SLA、非公開での報告については、SECURITY.md をご覧ください。

---

レジストリと評価

---

📄 ガバナンス、所有権、コミュニティ

• 公開者・組織: Smart Creations（OpenAI 組織 ID: org-deULP4GGInsTcWmuaHWp3lxy）

• 主任メンテナー・作者: Tareq Naji（@tareq7）

• ライセンス: MIT License（Copyright © 2026 Smart Creations & Tareq Naji）

• 引用: CITATION.cff

• メンテナー: MAINTAINERS.md

• ガバナンス: GOVERNANCE.md

• 製品ロードマップ: ROADMAP.md

• エージェント向けガイドライン: AGENTS.md

• 貢献: CONTRIBUTING.md

• 行動規範: CODE_OF_CONDUCT.md

• ディスカッション: GitHub Discussions

世界中のムスリム開発者コミュニティのために、精密さを追求して作られています。

検証済みの位置情報と計算に関する開示（v1.1.0）

礼拝時刻ツールでは、対応するcity、timezoneを指定した座標、または保存済みの固定設定一式を受け付けます。位置情報が不足している場合はlocation_requiredを返します。コネクターや IP による位置情報の推定、およびマッカへの自動フォールバックは使用しません。明示的に指定された呼び出しごとの入力は、固定設定より優先されます。ホストヘッダーにはエンドユーザーを反映する必要があります。

highLatitudeAdjustmentは、薄明の代替計算と極域での緯度制限を開示します。effectiveLatitudeは、+/-48度の代替計算が使われた場合にのみ含まれ、元の座標をそのまま返すことはありません。calculationDetailsは、位置情報の根拠と、地域、ユーザー、計算方法ごとのオフセットを報告します。礼拝時間の範囲を逆転させる無効なオフセットには、invalid_calculationを返します。設定情報ではfixedCoordinatesConfiguredとfixedCityConfiguredを公開しつつ、座標は秘匿します。

分析では、検証済みのChatGPTユーザーに関する仮名化された日単位のデータのみを、最長180日間保存します。個々のリクエスト、セッション識別子、エラー、位置情報、ボットのトラフィックは保存しません。スナップショットレポートは、UTC日ごとに最大1回更新されます。また、無料枠を保護するため、異なるユーザーが500人に達すると日次トラッキングを停止します。どちらのダッシュボードのエイリアスも、設定済みのサービス認証に従います。分析トークンまたはサービス用トークンがない場合、アクセスは公開されます。正確な信頼境界については、プライバシーポリシーをご覧ください。

設定と表示時刻の契約

明示的な座標を指定する場合、同じリクエスト内でtimezoneが必要です。保存済みの固定位置のタイムゾーンが、新たに指定された明示的な座標に引き継がれることはありません。calculationDetails.timezoneSourceは、明示指定、市区町村、保存済み、またはホストのいずれの入力かを示します。市区町村のタイムゾーンは、正規の市区町村タイムゾーンまたはIANAエイリアスと一致する必要があります。座標のタイムゾーンは、概算のオフライン検索と近隣の境界セルに照らして検証されます。矛盾する値を指定すると、expectedTimezoneを含むlocation_timezone_mismatchが返されます。市区町村または座標のいずれかを指定し、両方を指定しないでください。地理情報の既定の判定は、指定された表示用タイムゾーンではなく、検索結果に従います。

固定モードでは、サポート対象の市区町村、またはタイムゾーン付きの座標が必要です。新しい固定座標を指定する場合、同じ設定リクエスト内でタイムゾーンが必要です。設定の更新に失敗した場合、何も保存されません。auto_travelに切り替えても、再利用できるよう固定位置は保持されます。clearFixedLocation:trueを指定すると、市区町村、座標、タイムゾーンが削除され、自動移動モードが既定となります。それ以外の設定は保持されます。クリア操作は、位置またはタイムゾーンの置き換え、あるいは不完全な固定モード設定と併用できません。

識別済みユーザーの場合、prayer_windowとexact_windowは、祈りの時間帯／日付／モードの組み合わせごとに一度だけ通知し、persistentは祈りの時間帯を通じて通知します。ロケールの変更や通知の切り替えによって、重複排除の状態はリセットされません。匿名の呼び出しでは、重複排除の状態は保持されません。expiresAtUtcは引き続き祈りの時間帯の境界を示し、prayerWindowExpiresAtUtcは同じ境界を示します。また、reminderWindowExpiresAtUtcは通知の対象となる期間を示し、正確なモードでは祈りの時間帯の境界が上限となります。これらのフィールドは通知が送信される場合に表示されます。リージョンをまたぐKVの更新と重複排除は、引き続きベストエフォートです。

パレスチナ地域プロファイルは、エジプト方式にDhuhr -1分、Maghrib +3分のオフセットを適用した、設定済みのサービス上のヒューリスティックです。広範囲に適用される座標、タイムゾーン、国のルールは、管轄権を定めるものではありません。パレスチナの省庁がこれらのパラメーターを正確に採用しているかどうかは、一次資料で確認できていません。ユーザーは方式とオフセットを上書きできます。その他の地域設定はサービスの既定値であり、全国的な義務ではありません。方式の説明はAdhanのドキュメントに準拠しています。

サポート対象の市区町村名とエイリアスは、各位置入力スキーマと生成されるスキルで提示されます。このサービスが登録するツールは5つのみです。コネクター内に接尾辞付きの重複ツールや古いスキーマがある場合は、登録を更新する必要があります。これらは別個のサーバー操作ではありません。

タイムゾーンの検証には、@photostructure/tz-lookup 11.7.0（コンパクトな概算地理データ）を使用します。正規のIANAエイリアスは受け付けますが、サンプル地点のUTCオフセットが一致するだけでは不十分です。夏時間への移行日が異なる場合があるためです。境界付近では、約0.05度以内にある隣接する検索タイムゾーンを受け付け、nearby_boundaryとして開示します。これは管轄区域を正確に特定するものではありません。数学的な極では明示的に選択された民間タイムゾーンが保持され、海洋セルでは一致する航海用タイムゾーンまたは近隣の民間タイムゾーンが必要です。新規および更新された固定市区町村設定には、市区町村の正規タイムゾーンが保存されます。矛盾する値が指定された場合は拒否されます。従来の市区町村レコードは、読み取り時に他のデータを書き換えることなく正規の形で表示されます。

auto_travelモードでは、呼び出し元が現在の市区町村、または座標とタイムゾーンを指定する必要があります。IPによる自動位置特定はありません。移動中も保存済みの方式設定は有効です。exact_windowでは、保存済みの時間が使用されます。未設定の場合、オペレーターが上書きしない限り、サービスの既定値である20分が使用されます。時間を省略すると、既存の設定が保持されます。