Quran Cloud MCP Server

🚀 古蘭經雲MCP服務器

本項目是一個MCP服務器，專為大語言模型（LLM）訪問Quran API（https://alquran.cloud/api）而設計，旨在減少大語言模型在處理敏感文本（如古蘭經）時出現的幻覺問題，提升模型輸出的準確性和可靠性。

🚀 快速開始

幻覺是大語言模型在處理敏感數據時面臨的嚴重問題，尤其是像古蘭經這類每個字符都至關重要的文本。雖然提供上下文能有效降低幻覺風險，但每次請求都加載大型文本文件（如古蘭經）會導致效率低下。

本項目創建的MCP服務器，可將大語言模型連接到免費的Quran Cloud API，讓模型能夠按需獲取所需數據，有效解決了上述問題。

示例展示

• 原始Claude響應：
• 連接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

激活虛擬環境（根據系統不同）

• 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

💻 使用示例

將MCP服務器連接到Claude桌面應用

步驟1：下載並安裝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服務。