quran-search-engine-mcp

quran-search-engine-mcp é um servidor Model Context Protocol (MCP) que conecta assistentes de IA como o Claude Desktop a um motor de busca alcorânico dedicado. Ele previne erros de geração de texto ou alucinações por parte da IA ao rotear solicitações de busca através de uma camada de banco de dados verificada, retornando versículos árabes exatos e destacados com normalização avançada e correspondência baseada em lema e raiz.

GitHub
6
Experimente este MCPPatrocinado

Documentação

Quran Search Engine MCP

npm version MCP Registry smithery badge license Powered by quran-search-engine quran-search-engine

Um servidor MCP (Model Context Protocol) que oferece a clientes de IA acesso rápido, preciso e sem alucinações ao Alcorão — busca, navegação e morfologia — via stdio e Streamable HTTP.

Busque, navegue e explore o Alcorão por meio de 8 ferramentas MCP — versículos, suratas, lemas, raízes e morfologia. Hospedado em mcp.quran.us.kg. Em vez de depender de uma IA para "alucinar" ou prever versículos corânicos, esta ferramenta encaminha cada solicitação a um mecanismo de busca dedicado. A IA lida com a linguagem natural; o servidor retorna o texto corânico exato e literal.

Endpoint público

O servidor está hospedado publicamente em https://mcp.quran.us.kg/ (com front-end Cloudflare, estável). Sem chave de API, sem autenticação — o endpoint é aberto e habilitado para CORS em qualquer cliente.

RecursoURL
Servidor MCP (Streamable HTTP)https://mcp.quran.us.kg/
Verificação de saúdehttps://mcp.quran.us.kg/health
Página de statushttps://quran.us.kg

Recursos

  • 🔌 Compatível com MCP — Claude Desktop, Claude Web, ChatGPT, Cursor, VS Code e outros.
  • 🌐 Dois transportes — stdio para integrações locais, Streamable HTTP para remoto/hospedado.
  • 🔍 Oito ferramentas — busca em texto completo, metadados de suratas, navegação por versículos, consulta de lemas/raízes, morfologia.
  • 📖 Resultados precisos — cada versículo vem de um conjunto de dados verificado; sem LLM no processo.
  • 🛡️ HTTP reforçado — lista de permissões de host, limite de taxa por IP, limite de corpo, coletor de sessões, /health.

Instalação

# Use the public endpoint
# → point your MCP client at https://mcp.quran.us.kg/

# Or run the server locally (stdio)
npx -y quran-search-engine-mcp

Documentação

A documentação detalhada está em docs/:

  • Referência de ferramentas — cada ferramenta, seu esquema, formato de resposta e exemplos.
  • Integrações — Claude Desktop, Claude Web, ChatGPT, Cursor e outros.
  • Arquitetura — detalhes internos: transportes, carregamento de dados, reforço de HTTP.
  • Desenvolvimento — compilar, testar, adicionar uma nova ferramenta, implantar.

Início rápido (HTTP)

O caminho mais curto: use qualquer cliente MCP e aponte-o para https://mcp.quran.us.kg/. Para testes pontuais, a página de integrações mostra um trecho de Node de uso único que utiliza @modelcontextprotocol/sdk diretamente.

Início rápido (Docker)

docker compose up --build
# → "Quran MCP HTTP server listening on http://0.0.0.0:4000/"

Requisitos

  • Node.js 20+ (LTS recomendado)
  • npm, pnpm ou yarn

Licença

MIT — consulte LICENSE.

Contato

E-mail: contact@adelpro.us.kg