quran_cloud_mcp_server

MCP服务器，旨在帮助LLM访问古兰经API (https://alquran.cloud/api)，以防止古兰经文本方面的幻觉。

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

减少幻觉的一种方法是向LLM提供上下文，但当然，对于像《古兰经》这样的大量文本，将所有文本放入每个请求中效率不高。

因此，在这个仓库中，我创建了一个MCP服务器，它将你的LLM连接到一个免费的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

激活虚拟环境

在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桌面

下载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

点击工具图标