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服务。