Malaysia Prayer Time for Claude Desktop

機能 • インストール • 設定 • 使用方法 • API リファレンス • トラブルシューティング • 貢献 • ライセンス

---

概要

Malaysia Prayer Time MCP Server は、マレーシア全域の地域における正確なイスラム教の礼拝時間を提供します。このサーバーは Model Context Protocol（MCP）を実装し、Claude Desktop とシームレスに連携して、AI アシスタントを通じてリアルタイムの礼拝スケジュールを提供します。

このサーバーは waktusolat.app API を利用して JAKIM 検証済みの礼拝時間を取得し、市区町村、ゾーンコード、または座標による検索に対応しています。

機能

✅ 場所に基づく時間：マレーシアの任意の市区町村や地区の礼拝時間を取得します
✅ 座標への対応：緯度と経度の座標を使って礼拝時間を検索します
✅ ゾーンコードによる検索：JAKIM ゾーンコード（例：クアラルンプールの場合は SGR03）を使って直接検索します
✅ 完全な礼拝スケジュール：毎日のすべての礼拝時間（Fajr、日の出、Dhuhr、Asr、Maghrib、Isha）を取得します
✅ 現在の礼拝状況：現在および次の礼拝時間を特定します
✅ 堅牢なエラー処理：ネットワークの問題や API の変更に適切に対応します
✅ Claude とのシームレスな連携：MCP を介して Claude Desktop とスムーズに連携します

インストール

前提条件

• Python 3.10 以降
• Claude Desktop（最新バージョン）
• pip または uv パッケージマネージャー

オプション 1：GitHub からインストール

# Clone the repository
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

オプション 2：uv を使用（推奨）

# Clone the repository
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# Create and activate a virtual environment using uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e .

設定

Claude Desktop の設定

1. Claude Desktop の設定ファイルを作成または編集します。

macOS：

mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

mkdir -p %APPDATA%\Claude
notepad %APPDATA%\Claude\claude_desktop_config.json

2. 以下の設定を追加します（環境に合わせてパスを調整してください）。

{
    "mcpServers": {
        "malaysia-prayer-time": {
            "command": "/absolute/path/to/your/.venv/bin/python",
            "args": [
                "main.py"
            ],
            "cwd": "/absolute/path/to/mcp-server-malaysia-prayer-time"
        }
    }
}

3. Claude Desktop を完全に再起動します。

使用方法

設定が完了すると、Claude Desktop を通じて自然言語で礼拝時間を問い合わせることができます。

例

市区町村／ゾーンによる礼拝時間の取得

• 「今日のクアラルンプールの礼拝時間は？」
• 「マレーシアのイポーの礼拝時間を表示して」
• 「PRK02 の礼拝時間を取得して」（ゾーンコードを使用）

座標による礼拝時間の取得

• 「座標 3.1390, 101.6869 における礼拝時間は？」
• 「場所 5.4141, 100.3288 の礼拝スケジュールを表示して」

利用可能なゾーンの一覧表示

• 「マレーシアのすべての礼拝時間ゾーンを一覧表示して」
• 「利用可能な JAKIM ゾーンコードをすべて表示して」

API リファレンス

利用可能なツール

MCP サーバーは、以下のツールを Claude に公開します。

get_prayer_times

マレーシアの特定の市区町村またはゾーンコードの礼拝時間を取得します。

パラメーター：

• city（string、デフォルト："kuala lumpur"）：市区町村名またはゾーンコード（例："SGR03"）
• country（string、デフォルト："malaysia"）：現在は "malaysia" のみ対応しています
• date（string、デフォルト："today"）：YYYY-MM-DD 形式の日付、または "today"

get_prayer_times_by_coordinates

地理座標に基づいて礼拝時間を取得します。

パラメーター：

• latitude（float）：緯度座標
• longitude（float）：経度座標
• date（string、デフォルト："today"）：YYYY-MM-DD 形式の日付、または "today"

list_zones

マレーシアで利用可能なすべての礼拝時間ゾーンと、それぞれのコードを一覧表示します。

礼拝時間の情報

サーバーは以下の礼拝時間を提供します。

• Imsak（利用可能な場合、夜明け前の食事の時間）
• Fajr（夜明けの礼拝）
• Syuruk／日の出
• Dhuhr（正午の礼拝）
• Asr（午後の礼拝）
• Maghrib（日没の礼拝）
• Isha（夜の礼拝）

ゾーンのカバー範囲

このサーバーは現在、マレーシアのすべての JAKIM ゾーンに対応しています。座標ベースの検索では、以下の主要地域に対応しています。

• クアラルンプール／セランゴール：SGR01-SGR04
• ペラ：PRK01-PRK04
• ペナン：PNG01
• ジョホール：JHR01
• ケダ：KDH01
• トレンガヌ：TRG01
• クランタン：KTN01
• マラッカ：MLK01

トラブルシューティング

よくある問題

Claude がサーバーに接続できない

1. 設定パスが絶対パスであり、正しいことを確認します

2. Claude のログを確認します：

   # macOS
   tail -f ~/Library/Logs/Claude/mcp*.log
   
   # Windows
   type %APPDATA%\Claude\Logs\mcp*.log
   

3. サーバーを直接テストします：

   cd /path/to/mcp-server-malaysia-prayer-time
   python main.py
   

礼拝時刻が取得できない

1. インターネット接続を確認します
2. ゾーンコードが有効か確認します（list_zones を使用）
3. API が一時的に利用できない可能性があります。しばらくしてからもう一度お試しください

都市が見つからない

別の綴り、近隣の主要都市、または適切なゾーンコードをお試しください

貢献

貢献を歓迎します！以下の手順で貢献できます。

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/amazing-feature
3. 変更をコミットします：git commit -m 'Add some amazing feature'
4. ブランチにプッシュします：git push origin feature/amazing-feature
5. プルリクエストを作成します

開発環境のセットアップ

# Clone your fork
git clone https://github.com/yourusername/mcp-server-malaysia-prayer-time.git
cd mcp-server-malaysia-prayer-time

# Set up development environment
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"  # Installs dev dependencies

# Run tests
pytest

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については LICENSE ファイルをご覧ください。

謝辞

• waktusolat.app - 礼拝時刻データ API の提供
• Model Context Protocol - MCP フレームワークの提供
• JAKIM - 公式の礼拝時刻の提供
• Claude Desktop - AI 統合プラットフォームの提供

---