Quran Search Engine MCP

An MCP stdio server that exposes Quran search tools with Arabic normalization, lemma/root options, pagination, and highlights.

Features

MCP stdio server compatible with Claude Desktop
Quran search with Arabic normalization
Lemma and root search options
Pagination and highlighted matches

Requirements

Node.js LTS
pnpm

Install

pnpm install

Build

pnpm build

Local Development

pnpm dev

Test

pnpm test

Lint

pnpm lint

Use with Claude Desktop (Windows)

Build the server:

pnpm build

Edit the config file: %APPDATA%\Claude\claude_desktop_config.json
Add the server entry:

{
  "mcpServers": {
    "quran-search-engine-mcp": {
      "command": "node",
      "args": ["D:\\path\\to\\quran-search-engine-mcp\\dist\\server.js"]
    }
  }
}

Restart Claude Desktop.
Use it in chat:

“Search the Quran for الحمد and show the results.”

Uses quran-search-engine

This server builds on the quran-search-engine package for core search logic, Arabic normalization, lemma/root matching, and highlights.
See https://www.npmjs.com/package/quran-search-engine for details.

Publish

pnpm build
pnpm version patch
pnpm publish --access public

Contribute

See CONTRIBUTING.md.

Contact

Email: contact@adelpro.us.kg

License

MIT

quran-search-engine-mcp

Quick Install