quran_cloud_mcp_server

quran_cloud_mcp_server

帮助大模型访问 Quran API（https://alquran.cloud/api）的 MCP 服务，可避免 Quran 文本中的幻觉。

幻觉是个大问题，尤其是在处理敏感数据时，每个字符都至关重要。

减少幻觉的一种方法是向大模型提供上下文，但对于《古兰经》这样的大段文本，如果每次请求都包含全部文本，显然效率不高。

因此，在这个仓库中，我创建了一个 MCP 服务，可将大模型连接到免费的 API https://alquran.cloud/api，让模型只检索所需的数据。

此外，我还会向你展示如何将此 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

点击工具图标