What is io.github.adelpro/quran-search-engine-mcp?

Quran Search Engine MCP for AI tools. Provides Quran search, Arabic normalization, and highlighting.

How do I install io.github.adelpro/quran-search-engine-mcp?

Install io.github.adelpro/quran-search-engine-mcp via npm from https://registry.npmjs.org, then add the server config to your MCP client (Claude Desktop, Cursor, or VS Code).

Is io.github.adelpro/quran-search-engine-mcp open source?

Yes, io.github.adelpro/quran-search-engine-mcp is open source under the MIT license. Source code is available at https://github.com/adelpro/quran-search-engine-mcp.

What category does io.github.adelpro/quran-search-engine-mcp belong to?

io.github.adelpro/quran-search-engine-mcp is listed under Developer Tools MCP servers on MCPFind.

io.github.adelpro/quran-search-engine-mcp — MCP Server for Developer Tools

Quran Search Engine MCP

An MCP (Model Context Protocol) server that gives AI clients fast, accurate, hallucination-free access to the Quran — search, navigation, and morphology — over stdio and Streamable HTTP.

Search, navigate, and explore the Quran through 8 MCP tools — verses, surahs, lemmas, roots, and morphology. Hosted at mcp.quran.us.kg. Instead of relying on an AI to "hallucinate" or predict Quranic verses, this tool routes every request to a dedicated search engine. The AI handles the natural language; the server returns the exact, literal Quranic text.

Public endpoint

The server is publicly hosted at https://mcp.quran.us.kg/ (Cloudflare-fronted, stable). No API key, no auth — the endpoint is open and CORS-enabled for any client.

Resource	URL
MCP server (Streamable HTTP)	`https://mcp.quran.us.kg/`
Health check	`https://mcp.quran.us.kg/health`
Status page	`https://quran.us.kg`

Features

🔌 MCP compatible — Claude Desktop, Claude Web, ChatGPT, Cursor, VS Code, and others.
🌐 Two transports — stdio for local integrations, Streamable HTTP for remote/hosted.
🔍 Eight tools — full-text search, surah metadata, verse navigation, lemma/root lookup, morphology.
📖 Accurate results — every verse comes from a verified dataset; no LLM in the loop.
🛡️ Hardened HTTP — host allow-list, per-IP rate limit, body cap, session reaper, /health.

Install

# 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

Documentation

Detailed docs live under docs/:

Tools reference — every tool, its schema, response shape, and examples.
Integrations — Claude Desktop, Claude Web, ChatGPT, Cursor, and others.
Architecture — internals: transports, dataset loading, HTTP hardening.
Development — build, test, add a new tool, deploy.

Quick start (HTTP)

The shortest path: use any MCP client and point it at https://mcp.quran.us.kg/. For ad-hoc testing, the integrations page shows a one-off Node snippet that uses @modelcontextprotocol/sdk directly.

Quick start (Docker)

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

Requirements

Node.js 20+ (LTS recommended)
npm, pnpm, or yarn

License

MIT — see LICENSE.

Contact

Email: contact@adelpro.us.kg

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-adelpro-quran-search-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "quran-search-engine-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.adelpro/quran-search-engine-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.adelpro/quran-search-engine-mcp