How do I install Quran Search Engine?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Quran Search Engine need an API key?

No required environment variable is listed on this record.

What transport does Quran Search Engine use?

Quran Search Engine runs locally over stdio.

When was Quran Search Engine last checked?

Last checked 2026-11-09. Quran Search Engine MCP for AI tools. Provides Quran search, Arabic normalization, and highlighting.

Quran Search Engine MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.adelpro-quran-search-engine-mcp -- npx -y quran-search-engine-mcp@0.2.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.adelpro-quran-search-engine-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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: [email protected]