Malaysia Prayer Time MCP Server

概要

マレーシア祈祷時間MCPサーバーは、マレーシア全土のイスラム教の祈祷時間を正確に提供します。このサーバーはモデルコンテキストプロトコル（MCP）を実装しており、Claude Desktopとシームレスに統合することで、AIアシスタントを通じてリアルタイムの祈祷スケジュールを直接提供します。

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

Related MCP server: Azan-MCP

特徴

✅位置情報に基づいた時間：マレーシアのどの都市や地区でも礼拝時間を確認できます
✅座標サポート：緯度と経度の座標を使用して祈りの時間を検索します
✅ゾーンコードアクセス：JAKIMゾーンコードを使用して直接クエリを実行します（例：クアラルンプールの場合はSGR03 ）
✅完全な祈りのスケジュール：毎日の祈りの時間をすべて取得します（ファジュル、日の出、ズフル、アスル、マグリブ、イシャ）
✅現在の祈りの状況：現在の祈りの時間と次の祈りの時間を決定します
✅堅牢なエラー処理: ネットワークの問題や 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デスクトップの設定

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

macOS :

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

ウィンドウズ:

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 (文字列、デフォルト: "kuala lumpur"): 都市名またはゾーンコード (例: "SGR03")

• country （文字列、デフォルト：「マレーシア」）：現在は「マレーシア」のみをサポートしています

• date (文字列、デフォルト: "today"): YYYY-MM-DD形式の日付または"today"

get_prayer_times_by_coordinates

地理座標に基づいて祈りの時間を取得します。

パラメータ:

• latitude （浮動小数点数）: 緯度座標

• longitude （浮動小数点）: 経度座標

• date (文字列、デフォルト: "today"): YYYY-MM-DD形式の日付または"today"

list_zones

マレーシアで利用可能なすべての礼拝時間帯とそれに対応するコードを一覧表示します。

礼拝時間のご案内

サーバーは次の祈りの時間を提供します:

• イムサック（夜明け前の食事時間、可能であれば）

• ファジュル（夜明けの祈り）

• シュルク/サンライズ

• ズフル（正午の祈り）

• アスル（午後の祈り）

• マグリブ（日没の祈り）

• イシャ（夜の祈り）

ゾーンカバレッジ

サーバーは現在、マレーシアのすべてのJAKIMゾーンをサポートしています。座標ベースの検索は、以下の主要エリアをサポートしています。

• クアラルンプール/セランゴール: SGR01-SGR04

• ペラ州: PRK01-PRK04

• ペナン: PNG01

• ジョホール：JHR01

• ケダ州: KDH01

• トレンガヌ州: TRG01

• ケランタン州: KTN01

• マラッカ：MLK01

トラブルシューティング

よくある問題

クロードはサーバーに接続できません

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を提供する

• モデルコンテキストプロトコル- MCPフレームワーク向け

• JAKIM - 公式の祈りの時間

• Claude Desktop - AI統合プラットフォーム向け