Quran Cloud

Accede a la API de Quran desde alquran.cloud para recuperar texto coránico preciso y reducir alucinaciones del LLM.

Documentación

quran_cloud_mcp_server

Servidor MCP para ayudar a los LLMs a acceder a la API del Corán (https://alquran.cloud/api) para prevenir la alucinación con el texto del Corán.

La alucinación es un gran problema, especialmente cuando trabajas con datos sensibles donde cada carácter es importante.

Una forma de reducir la alucinación es proporcionando el contexto a tu LLM, pero, por supuesto, con un gran bloque de texto como el Sagrado Corán, no es eficiente si pones todo el texto en cada solicitud.

Entonces, en este repositorio he creado un servidor MCP que conecta tu LLM a una API gratuita https://alquran.cloud/api que permite a tu modelo recuperar solo los datos que necesita.

Además, te mostraré cómo podemos conectar este servidor MCP a la aplicación de escritorio de Claude.

Ejemplo de la respuesta original de Claude

Claude original response

Ejemplo de la nueva respuesta de Claude después de conectar al servidor MCP de Search-Quran

Claude New response

Instalación

Asegúrate de tener Python 3.13 y pip.

Abre tu terminal y escribe estos comandos.

Clonación

git clone https://github.com/marwanWaly/quran_cloud_mcp_server.git

Moverse al directorio del proyecto

cd quran_cloud_mcp_server

Crear entorno virtual

python -m venv .venv

Activar el entorno virtual

En Windows

.\venv\Scripts\activate

En Mac o Linux

source .venv/bin/activate

Instalación de paquetes de Python

Usa el gestor de paquetes pip para instalar requirements.txt.

pip install -r requirements.txt

Crear archivo .env

OPENAI_API_KEY=Your-secret-key

Ejecutar en la terminal

python client.py

ahora puedes chatear directamente con GPT4o en tu terminal

server running in terminal

Conectar el servidor a Claude Desktop

Descarga el escritorio de Claude y ábrelo.

Paso 1

Selecciona Configuración desde el menú Archivo.

step 1

Paso 2

Haz clic en Developer y luego en Edit Config

step 2

Paso 3

Abre claude_desktop_config.json

step 3

Paso 4

Escribe esta configuración en el archivo.

{
  "mcpServers": {
    "Search-Quran": {
      "command": "python",
      "args": [
        "PROJECT_PATH_ON_YOUR_PC\\server.py"
      ],
      "host": "127.0.0.1",
      "port": 8080,
      "timeout": 30000
    }
  }
}

No olvides reemplazar PROJECT_PATH_ON_YOUR_PC con la ruta absoluta al servidor de tu proyecto.

step 4

Paso 5

Reinicia la aplicación de Claude (asegúrate de que esté completamente cerrada desde tu barra de tareas haciendo clic derecho en el icono de Claude y seleccionando Quit)

Comprueba si el nuevo MCP ha sido agregado.

step 5

Haz clic en el icono de herramientas.

step 6