quran-mcp-server

Quran.com API 用 MCP サーバー

公式REST API v4を介して Quran.com コーパスと対話するための MCP サーバー。

概要

これは、OpenAPI 仕様から生成されたモデル コンテキスト プロトコル (MCP) サーバーです。

エンドポイント

API の次のエンドポイントは、LLM が互換性のあるクライアント経由で使用できるツールとして利用可能になりました。

章

• GET /chapters - 章の一覧
• GET /chapters/{id} - 章を取得
• GET /chapters/{chapter_id}/info - 章情報を取得する

詩

• GET /verses/by_chapter/{chapter_number} - 章/スーラ番号で詩節を取得します
• GET /verses/by_page/{page_number} - 特定のマダニ・ムシャフページのすべての詩を取得します
• GET /verses/by_juz/{juz_number} - Juz番号で詩を取得します
• GET /verses/by_hizb/{hizb_number} - Hizb番号で詩を取得します
• GET /verses/by_rub/{rub_el_hizb_number} - Rub el Hizb 番号で詩節を取得します
• GET /verses/by_key/{verse_key} - キーで詩を取得する
• GET /verses/random - ランダムな詩を取得する

ジュズ

• GET /juzs - すべてのjuzsのリストを取得します

検索

• GET /search - 特定の用語でコーランを検索

翻訳

• GET /resources/translations - 利用可能な翻訳のリストを取得する
• GET /resources/translations/{translation_id}/info - 特定の翻訳の情報を取得します

タフシール

• GET /resources/tafsirs - 利用可能なタフシールのリストを取得します
• GET /resources/tafsirs/{tafsir_id}/info - 特定のタフシールの情報を取得します
• GET /quran/tafsirs/{tafsir_id} - 単一のタフシルを取得します

オーディオ

• GET /resources/chapter_reciters - 章朗読者リスト
• GET /resources/recitation_styles - 利用可能な朗読スタイルを取得します

言語

• GET /resources/languages - すべての言語を取得する

設定

要件

• Node.js 22以上
• ドッカー

Dockerイメージの構築

Docker ベースの本番環境モードを使用する前に、Docker イメージをビルドする必要があります。

クロードデスクトップ統合

この MCP サーバーを Claude Desktop で使用するには、 claude_desktop_config.jsonファイル (通常、macOS では~/Library/Application Support/Claude/claude_desktop_config.json 、Windows では%APPDATA%\Claude\claude_desktop_config.jsonにあります) に次の構成を追加します。

Dockerベースのプロダクションモード

プロダクションモード（Node.js）

開発モード

重要な注意事項:

• /path/to/quran-mcp-serverシステム上のこのリポジトリへの実際のパスに置き換えます。
• まず、 npm run buildまたはdocker build -t quran-mcp-server .プロダクションモード構成を使用している場合は、
• Quran.com API で必要な場合は、 your_api_key_if_needed実際の API キーに置き換えます。
• すでに他のMCPサーバーが設定されている場合は、この設定を既存のmcpServersオブジェクトに追加します。
• 設定を更新した後、変更を有効にするためにClaude Desktopを再起動してください。

環境変数

• API_KEY : 認証用のAPIキー
• PORT : サーバーポート (デフォルト: 言語に応じて 8000 または 3000)
• VERBOSE_MODE : APIリクエストとレスポンスの詳細なログ記録を有効にするには「true」に設定します（デフォルト: false）

詳細モード

VERBOSE_MODE 「true」に設定すると、サーバーはAPIリクエストとレスポンスに関する詳細情報をコンソールに記録します。これは、APIインタラクションのデバッグと監視に役立ちます。

詳細ログには次の内容が含まれます。

• リクエスト: 受信したリクエストごとにツール名と引数を記録します。
• 応答: 各応答のツール名と結果データを記録します。
• エラー: エラー名、メッセージ、スタック トレースなどの詳細なエラー情報を記録します (利用可能な場合)

各ログ エントリにはタイムスタンプが付けられ、ログ タイプ (REQUEST、RESPONSE、または ERROR) がプレフィックスとして付加されるため、簡単に識別できます。

テスト

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。