Quran MCP Server

🚀 Quran.com API の MCP サーバー

公式の REST API v4 を通じて、Quran.com のテキストとやり取りするための MCP サーバーです。

🚀 クイックスタート

この MCP サーバーは、OpenAPI 仕様 (v4.json) から生成されています。LLM は互換性のあるクライアントを通じて、以下の API エンドポイントを利用できます。

✨ 主な機能

以下の API エンドポイントが提供されており、LLM は互換性のあるクライアントを通じて利用できます。

章

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

経文

• GET /verses/by_chapter/{chapter_number} - 章/スラ番号で経文を取得
• GET /verses/by_page/{page_number} - 特定の Madani Mushaf ページのすべての経文を取得
• GET /verses/by_juz/{juz_number} - ジュズ番号で経文を取得
• GET /verses/by_hizb/{hizb_number} - ヒズブ番号で経文を取得
• GET /verses/by_rub/{rub_el_hizb_number} - ルブ・エル・ヒズブ番号で経文を取得
• GET /verses/by_key/{verse_key} - キーで経文を取得
• GET /verses/random - ランダムな経文を取得

ジュズ

• GET /juzs - すべてのジュズの一覧を取得

検索

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

翻訳

• GET /resources/translations - 利用可能な翻訳の一覧を取得
• GET /resources/translations/{translation_id}/info - 特定の翻訳の情報を取得

📦 インストール

環境変数

環境設定例

bash を使用する場合

export API_KEY="your_api_key_here"
export PORT=8000
export VERBOSE_MODE=true

PowerShell (Windows) を使用する場合

$env:API_KEY = "your_api_key_here"
$env:PORT = 8000
$env:VERBOSE_MODE = "true"

Claude Desktop での設定

claudius.json 設定ファイルに以下の内容を追加します。

設定例

{
  "mcpServers": {
    "quranComMCP": {
      "type": "custom",
      "executablePath": "/path/to/node/bin/npm",
      "scriptName": "start",
      "args": [
        "--port",
        "8000",
        "--api-key",
        "your_api_key_here"
      ],
      "environmentVariables": {
        "VERBOSE_MODE": "true"
      }
    }
  }
}

💻 使用例

基本的な使用法

# テストを実行
npm test

📚 ドキュメント

詳細ログモード

VERBOSE_MODE を 'true' に設定すると、サーバーはコンソールに詳細な API リクエストとレスポンスのログを出力します。これは API のやり取りのデバッグや監視に非常に役立ちます。

詳細ログには以下が含まれます。

• リクエスト：各受信リクエストのツール名とパラメータを記録
• レスポンス：各レスポンスの結果データとツール名を記録
• エラー：エラー情報（エラー名、メッセージ、スタックトレース（利用可能な場合））を記録

各ログにはタイムスタンプが付けられ、識別子（REQUEST、RESPONSE、ERROR）が前に付けられているため、識別が容易です。

完全なログ例

VERBOSE_MODE を有効にすると、コンソール出力は以下のようになります。

[2023-10-01 12:34:56] REQUEST - GET /verses/random 
[2023-10-01 12:34:57] RESPONSE - {
  "chapter": {
    "number": 1,
    "name": "Al-Fatiha",
    "translation": "The Opening"
  },
  "verse": {
    "number": 1,
    "text": "In the name of Allah, Most Gracious, Most Merciful..."
  }
}
[2023-10-01 12:35:01] ERROR - 経文の取得中にエラーが発生しました：ネットワーク接続が切断されました

📄 ライセンス

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

まとめ

API_KEY を設定し、ポートを指定し、詳細ログモードを有効にすることで、Quran.com API を MCP サーバーに簡単に統合し、Claude Desktop で利用できます。