{
  "markdown": "# Quran Search Engine MCP\n\n[![npm version](https://img.shields.io/npm/v/quran-search-engine-mcp.svg)](https://www.npmjs.com/package/quran-search-engine-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue?style=flat&logo=github)](https://github.com/modelcontextprotocol/servers)\n[![smithery badge](https://smithery.ai/badge/adelpro/quran-search-engine-mcp)](https://smithery.ai/servers/adelpro/quran-search-engine-mcp)\n[![license](https://img.shields.io/npm/l/quran-search-engine-mcp.svg)](LICENSE)\n[![Powered by quran-search-engine](https://img.shields.io/badge/Powered%20by-quran--search--engine-green)](https://github.com/adelpro/quran-search-engine)\n[![quran-search-engine](https://img.shields.io/npm/v/quran-search-engine.svg?label=engine&color=blue)](https://www.npmjs.com/package/quran-search-engine)\n\nAn MCP (Model Context Protocol) server that gives AI clients fast, accurate,\nhallucination-free access to the Quran — search, navigation, and morphology —\nover **stdio** and **Streamable HTTP**.\n\n> Search, navigate, and explore the Quran through 8 MCP tools — verses, surahs, lemmas, roots, and morphology. Hosted at mcp.quran.us.kg.\n> Instead of relying on an AI to \"hallucinate\" or predict Quranic verses, this\n> tool routes every request to a dedicated search engine. The AI handles the\n> natural language; the server returns the exact, literal Quranic text.\n\n## Public endpoint\n\nThe server is publicly hosted at **<https://mcp.quran.us.kg/>**\n(Cloudflare-fronted, stable). No API key, no auth — the endpoint is open and\nCORS-enabled for any client.\n\n| Resource | URL |\n| --- | --- |\n| MCP server (Streamable HTTP) | `https://mcp.quran.us.kg/` |\n| Health check | `https://mcp.quran.us.kg/health` |\n| Status page | `https://quran.us.kg` |\n\n## Features\n\n- 🔌 **MCP compatible** — Claude Desktop, Claude Web, ChatGPT, Cursor, VS Code, and others.\n- 🌐 **Two transports** — stdio for local integrations, Streamable HTTP for remote/hosted.\n- 🔍 **Eight tools** — full-text search, surah metadata, verse navigation, lemma/root lookup, morphology.\n- 📖 **Accurate results** — every verse comes from a verified dataset; no LLM in the loop.\n- 🛡️ **Hardened HTTP** — host allow-list, per-IP rate limit, body cap, session reaper, `/health`.\n\n## Install\n\n```bash\n# Use the public endpoint\n# → point your MCP client at https://mcp.quran.us.kg/\n\n# Or run the server locally (stdio)\nnpx -y quran-search-engine-mcp\n```\n\n## Documentation\n\nDetailed docs live under [`docs/`](docs/index.md):\n\n- [Tools reference](docs/tools.md) — every tool, its schema, response shape, and examples.\n- [Integrations](docs/integrations.md) — Claude Desktop, Claude Web, ChatGPT, Cursor, and others.\n- [Architecture](docs/architecture.md) — internals: transports, dataset loading, HTTP hardening.\n- [Development](docs/development.md) — build, test, add a new tool, deploy.\n\n## Quick start (HTTP)\n\nThe shortest path: use any MCP client and point it at `https://mcp.quran.us.kg/`.\nFor ad-hoc testing, the [integrations page](docs/integrations.md#other-mcp-compatible-clients)\nshows a one-off Node snippet that uses `@modelcontextprotocol/sdk` directly.\n\n## Quick start (Docker)\n\n```bash\ndocker compose up --build\n# → \"Quran MCP HTTP server listening on http://0.0.0.0:4000/\"\n```\n\n## Requirements\n\n- Node.js 20+ (LTS recommended)\n- npm, pnpm, or yarn\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Contact\n\nEmail: <contact@adelpro.us.kg>\n",
  "bytes": 3427,
  "sha": "76d1f13055d5606aec2771e057e318227f3f2af87b0dcaf92c3ce79a2d2fc2c6",
  "repo_slug": "adelpro/quran-search-engine-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_adelpro_quran_search_engine_mc_1dd5db84/readme"
}