Quran Cloud

Acesse a API do Quran do alquran.cloud para recuperar textos corânicos precisos e reduzir alucinações do LLM.

GitHubExperimente este MCPPatrocinado

Documentação

quran_cloud_mcp_server

Servidor MCP para ajudar LLMs a obter acesso à API do Alcorão (https://alquran.cloud/api) para prevenir a alucinação com o texto do Alcorão.

A alucinação é um grande problema, especialmente quando você está trabalhando com dados sensíveis onde cada caractere é importante.

Uma forma de reduzir a alucinação é fornecendo contexto ao seu LLM, mas, é claro, com grandes blocos de texto como o Sagrado Alcorão, não é eficiente colocar todo o texto em cada requisição.

Então, neste repositório eu criei um servidor MCP que conecta seu LLM a uma API gratuita https://alquran.cloud/api que permite ao seu modelo recuperar apenas os dados de que precisa.

Além disso, vou mostrar como podemos conectar este servidor MCP ao aplicativo de desktop Claude.

Exemplo da resposta original do Claude

Claude original response

Exemplo da nova resposta do Claude após conectar ao servidor MCP Search-Quran

Claude New response

Instalação

Certifique-se de ter Python 3.13 e pip instalados

Abra seu terminal e digite estes comandos

Clonando

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

Mover para o diretório do projeto

cd quran_cloud_mcp_server

Criar ambiente virtual

python -m venv .venv

Ativar o ambiente virtual

No Windows

.\venv\Scripts\activate

No Mac ou Linux

source .venv/bin/activate

Instalação dos pacotes Python

Use o gerenciador de pacotes pip para instalar o requirements.txt.

pip install -r requirements.txt

Criar arquivo .env

OPENAI_API_KEY=Your-secret-key

Executar no terminal

python client.py

agora você pode conversar diretamente com o GPT4o no seu terminal

server running in terminal

Conectar o servidor ao Claude Desktop

Baixe o Claude desktop e abra-o

Passo 1

Selecione configurações no menu de arquivo

step 1

Passo 2

Clique em Developer e depois em Edit Config

step 2

Passo 3

Abra claude_desktop_config.json

step 3

Passo 4

Escreva esta configuração no arquivo

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

Não se esqueça de substituir PROJECT_PATH_ON_YOUR_PC pelo caminho absoluto para o servidor do seu projeto

step 4

Passo 5

Reinicie o aplicativo Claude (certifique-se de que ele esteja completamente fechado na sua barra de tarefas clicando com o botão direito no ícone do Claude e selecionando Quit)

Verifique se o novo MCP foi adicionado

step 5

Clique no ícone de ferramentas

step 6