quran_cloud_mcp_server

为LLM提供访问Quran API（https://alquran.cloud/api）的MCP服务器，以减少对敏感文本（如古兰经）的幻觉。

幻觉问题

幻觉是一个严重的问题，特别是在处理每个字符都至关重要的敏感数据时。通过提供上下文可以有效降低幻觉风险，但像古兰经这样的大型文本文件在每次请求中加载所有内容显然效率低下。

在这个项目中，我们创建了一个MCP服务器，将LLM连接到免费的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，确保新配置生效。

5. 验证MCP服务器连接

   • 点击工具图标检查是否成功添加了新的MCP服务。