マレーシアの祈りの時間MCPサーバー

概要

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

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

特徴

✅位置情報に基づいた時間：マレーシアのどの都市や地区でも礼拝時間を確認できます
✅座標サポート：緯度と経度の座標を使用して祈りの時間を検索します
✅ゾーンコードアクセス：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デスクトップの設定

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

次の構成を追加します (設定に応じてパスを調整します)。

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

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

トラブルシューティング

よくある問題

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

構成パスが絶対的で正しいことを確認する
Claude のログを確認します。
# macOS tail -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
サーバーを直接テストします。
cd /path/to/mcp-server-malaysia-prayer-time python main.py

礼拝時間はありません

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

都市が見つかりません

別のスペル、近くの主要都市、または適切なゾーンコードを使用してみてください

貢献

貢献を歓迎します！貢献方法は次のとおりです。

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

開発セットアップ

# 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統合プラットフォーム向け