🚀 古兰经云MCP服务器
本项目是一个MCP服务器，旨在为大语言模型（LLM）提供访问古兰经API（https://alquran.cloud/api）的能力，有效减少对敏感文本（如古兰经）的幻觉问题，保障数据的准确性和可靠性。
🚀 快速开始
幻觉是处理敏感数据时的严重问题，尤其是像古兰经这类每个字符都至关重要的文本。虽然提供上下文能降低幻觉风险，但每次请求都加载大型文本文件并不高效。本项目创建的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
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服务。