quran_cloud_mcp_server

quran_cloud_mcp_server

LLM が Quran API（https://alquran.cloud/api）にアクセスできるようにする MCP サーバーです。Quran のテキストに関するハルシネーションを防ぎます。

ハルシネーションは、文字の一つひとつが重要なセンシティブなデータを扱う場合、特に大きな問題です。

ハルシネーションを減らす方法の一つは、LLM にコンテキストを提供することです。ただし、聖典である Quran のように大きなテキストを毎回のリクエストにすべて含めるのは、効率的ではありません。

そこでこのリポジトリでは、LLM を無料の API https://alquran.cloud/api に接続する MCP サーバーを作成しました。これにより、モデルは必要なデータだけを取得できます。

また、この MCP サーバーを Claude デスクトップアプリケーションに接続する方法も紹介します。

Claude の元の回答例

Search-Quran MCP サーバーに接続した後の Claude の新しい回答例

インストール

Python 3.13 と pip がインストールされていることを確認してください。

ターミナルを開き、次のコマンドを入力します。

クローン

git clone https://github.com/marwanWaly/quran_cloud_mcp_server.git

プロジェクトディレクトリに移動

cd quran_cloud_mcp_server

仮想環境を作成

python -m venv .venv

venv を有効化

Windows の場合

.\venv\Scripts\activate

Mac または Linux の場合

source .venv/bin/activate

Python パッケージをインストール

パッケージマネージャーの pip を使って requirements.txt をインストールします。

pip install -r requirements.txt

.env ファイルを作成

OPENAI_API_KEY=Your-secret-key

ターミナルで実行

python client.py

これで、ターミナルから GPT4o と直接チャットできます。

サーバーを Claude Desktop に接続

Claude デスクトップアプリをダウンロードして開きます。

ステップ 1

ファイルメニューから設定を選択します。

ステップ 2

Developer をクリックしてから、Edit Config をクリックします。

ステップ 3

claude_desktop_config.json を開きます。

ステップ 4

ファイルに次の設定を記述します。

{
  "mcpServers": {
    "Search-Quran": {
      "command": "python",
      "args": [
        "PROJECT_PATH_ON_YOUR_PC\\server.py"
      ],
      "host": "127.0.0.1",
      "port": 8080,
      "timeout": 30000
    }
  }
}

PROJECT_PATH_ON_YOUR_PC をプロジェクトサーバーの絶対パスに置き換えるのを忘れないでください。

ステップ 5

Claude アプリを再起動します（タスクバーにある Claude アイコンを右クリックして Quit を選択し、完全に終了させてください）。

新しい MCP が追加されたことを確認します。

ツールアイコンをクリックします。