MCP Server Malaysia Prayer Time

🚀 マレーシア祈祷時間サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）に基づくマレーシアの祈祷時間サーバーです。waktusolat.appが提供するAPIを通じて公式の祈祷時間データを取得し、Claude Desktopと統合しています。

🚀 クイックスタート

このサーバーを使用する前に、以下の手順でインストールと設定を行ってください。

✨ 主な機能

• 都市または座標位置に基づく祈祷時間を取得します。
• 以下の時間点をサポートしています：
  • Imsak（提供されている場合、破曉前の断食時間）
  • Fajr（夜明けの祈祷）
  • Syuruk/Sunrise（日の出）
  • Dhuhr（正午の祈祷）
  • Asr（午後の祈祷）
  • Maghrib（日没の祈祷）
  • Isha（夜の祈祷）

📦 インストール

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-server-malaysia-prayer-times.git
   cd mcp-server-malaysia-prayer-times
   

2. 仮想環境を作成してアクティブにします：

   python -m venv .venv
   source .venv/bin/activate  #  macOS と Linux の場合
   # または
   .venv\Scripts\activate  # Windows の場合
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

📚 ドキュメント

サーバー設定

1. プロジェクトのルートディレクトリに config.json ファイルを作成します。
2. 以下の内容を追加します：

   {
     "api_key": "your_api_key_from_waktusolat",
     "debug_mode": true,
     "logging": {
       "level": "INFO",
       "file_path": "server.log"
     }
   }
   

3. 環境変数 NODE_ENV を production に設定するか、デフォルトのままにします。

クライアント設定

1. client/config.js に以下を追加します：

   export const API_BASE_URL = 'http://localhost:5000';
   export const TIMEOUT = 5000;
   

💻 使用例

基本的な使用法

都市に基づく位置の祈祷時間を取得する

const response = await fetch(`${API_BASE_URL}/prayer-times?city=Kuala%20Lumpur&country=Malaysia`);

座標に基づく位置の祈祷時間を取得する

const response = await fetch(`${API_BASE_URL}/coordinates?lat=3.14&lon=101.69`);

📚 ドキュメント

API リファレンス

エンドポイントの説明

• /prayer-times

  • メソッド: GET
  • パラメータ:
    • city (必須)：都市名
    • country (必須)：国名、デフォルトはマレーシア
    • date (オプション)：日付、形式は YYYY-MM-DD または "today"

• /coordinates

  • メソッド: GET
  • パラメータ:
    • lat (必須)：緯度
    • lon (必須)：経度
    • date (オプション)：日付、形式は YYYY-MM-DD または "today"

レスポンス構造

{
  "imsak": "05:30",
  "fajr": "06:00",
  "sunrise": "07:00",
  "dhuhr": "12:00",
  "asr": "15:00",
  "maghrib": "18:00",
  "isha": "19:30"
}

トラブルシューティング

問題：サーバーに接続できない場合

1. 設定ファイルのパスが正しく、ファイルが存在することを確認します。
2. ログを確認します：

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

3. サーバーが実行されていることをテストします：

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

🤝 貢献ガイド

貢献を歓迎します！

1. リポジトリをフォークします。
2. 機能ブランチを作成します：git checkout -b feature/amazing-feature
3. 変更をコミットします：git commit -m "新機能を追加しました"
4. オリジンにプッシュして、プルリクエストを作成します。

📄 ライセンス

このプロジェクトは、MITライセンスに従います。

付録

• サポートされている都市のリストは、waktusolat.appの公式ドキュメントを参照してください。
• 詳細なエラー処理とログ記録については、logging モジュールを確認してください。