quran-search-engine-mcp

quran-search-engine-mcp es un servidor del Model Context Protocol (MCP) que conecta asistentes de IA como Claude Desktop a un motor de búsqueda coránico dedicado. Evita errores de generación de texto o alucinaciones de la IA al enrutar las solicitudes de búsqueda a través de una capa de base de datos verificada, devolviendo versos árabes exactos y resaltados con normalización avanzada, lemas y coincidencia basada en raíces.

GitHub
6
Prueba este MCPPatrocinado

Documentación

Quran Search Engine MCP

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

Un servidor MCP (Model Context Protocol) que brinda a los clientes de IA acceso rápido, preciso y sin alucinaciones al Corán — búsqueda, navegación y morfología — a través de stdio y Streamable HTTP.

Busca, navega y explora el Corán a través de 8 herramientas MCP — versículos, azoras, lemas, raíces y morfología. Alojado en mcp.quran.us.kg. En lugar de depender de una IA para "alucinar" o predecir versículos coránicos, esta herramienta enruta cada solicitud a un motor de búsqueda dedicado. La IA maneja el lenguaje natural; el servidor devuelve el texto coránico exacto y literal.

Endpoint público

El servidor está alojado públicamente en https://mcp.quran.us.kg/ (con Cloudflare, estable). Sin clave de API, sin autenticación: el endpoint está abierto y habilitado para CORS para cualquier cliente.

RecursoURL
Servidor MCP (Streamable HTTP)https://mcp.quran.us.kg/
Verificación de saludhttps://mcp.quran.us.kg/health
Página de estadohttps://quran.us.kg

Características

  • 🔌 Compatible con MCP — Claude Desktop, Claude Web, ChatGPT, Cursor, VS Code y otros.
  • 🌐 Dos transportes — stdio para integraciones locales, Streamable HTTP para remoto/alojado.
  • 🔍 Ocho herramientas — búsqueda de texto completo, metadatos de azoras, navegación de versículos, consulta de lemas/raíces, morfología.
  • 📖 Resultados precisos — cada versículo proviene de un conjunto de datos verificado; sin LLM en el proceso.
  • 🛡️ HTTP reforzado — lista blanca de hosts, límite de tasa por IP, límite de cuerpo, recolector de sesiones, /health.

Instalación

# 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

Documentación

La documentación detallada se encuentra en docs/:

  • Referencia de herramientas — cada herramienta, su esquema, forma de respuesta y ejemplos.
  • Integraciones — Claude Desktop, Claude Web, ChatGPT, Cursor y otros.
  • Arquitectura — internos: transportes, carga de conjuntos de datos, refuerzo HTTP.
  • Desarrollo — compilar, probar, agregar una nueva herramienta, implementar.

Inicio rápido (HTTP)

El camino más corto: usa cualquier cliente MCP y apúntalo a https://mcp.quran.us.kg/. Para pruebas ad-hoc, la página de integraciones muestra un fragmento de Node único que usa @modelcontextprotocol/sdk directamente.

Inicio rápido (Docker)

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

Requisitos

  • Node.js 20+ (se recomienda LTS)
  • npm, pnpm o yarn

Licencia

MIT — ver LICENSE.

Contacto

Correo electrónico: contact@adelpro.us.kg