Quran Cloud MCP Server

🚀 クラウド版Quran MCPサーバー

このプロジェクトは、LLM（大規模言語モデル）がQuran API（https://alquran.cloud/api）にアクセスするためのMCPサーバーを提供します。これにより、コーランのような敏感なテキストに関するモデルの「幻覚」（誤った出力）を減らすことができます。

🚀 クイックスタート

このMCPサーバーを使用することで、LLMは必要なデータをQuran Cloud APIから取得でき、敏感なテキストに関する幻覚のリスクを低減できます。以下に、サーバーのセットアップとClaudeデスクトップアプリへの接続方法を説明します。

✨ 主な機能

• LLMにQuran APIへのアクセスを提供し、敏感なテキストの幻覚を低減します。
• 必要に応じてデータを取得することで、大規模なテキストファイルの読み込みに関する効率問題を解決します。

📦 インストール

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

リポジトリのクローン

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

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

cd quran_cloud_mcp_server

仮想環境の作成

python -m venv .venv

仮想環境のアクティブ化（システムに応じて）

• Windows：

  .\venv\Scripts\activate
  

• Mac/Linux：

  source .venv/bin/activate
  

依存関係のインストール

pip install -r requirements.txt

.envファイルの作成

OPENAI_API_KEY=Your-secret-key

サーバーの起動

python client.py

💻 使用例

元のClaudeの応答

MCPサーバーに接続後のClaudeの応答

📚 ドキュメント

ClaudeデスクトップアプリへのMCPサーバーの接続

1. Claudeのダウンロードとインストール

ClaudeのダウンロードリンクからClaudeをダウンロードしてインストールしてください。

2. Claudeの設定

Claudeを開き、メニューバーから設定を選択します。次に、開発者をクリックして設定の編集を選択します。

3. 設定ファイルの変更

claude_desktop_config.jsonを開き、以下の内容を追加します。

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

YOUR_PROJECT_PATHを実際のプロジェクトパスに置き換えてください。

4. Claudeの再起動

Claudeを再起動して、新しい設定が適用されるようにします。

5. MCPサーバー接続の検証

ツールアイコンをクリックして、新しいMCPサービスが正常に追加されていることを確認します。