Name: quran search engine mcp
Author: adelpro

Was kannst du mit quran search engine mcp machen?

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

Installation

quran search engine mcp zu deinem Client hinzufügen. Wähl den, den du nutzt.

claude mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp

codex mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp

amp mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp

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

Add to `claude_desktop_config.json`, then restart Claude Desktop.

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

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"quran-search-engine-mcp","command":"npx","args":["-y","quran-search-engine-mcp"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

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

Add to `~/.codeium/windsurf/mcp_config.json`.

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

Add to `cline_mcp_settings.json` via the MCP Servers panel.

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

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "quran-search-engine-mcp": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "quran-search-engine-mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "quran-search-engine-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "quran-search-engine-mcp"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y quran-search-engine-mcp

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Unvollständig

Dokumentation17/25
Pflege19/25
Vertrauen13/20
Funktionsumfang0/15
Installation12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 25 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Vollständige Kriterien lesen →

Versionsverlauf

Versionen	Veröffentlicht
0.2.1Aktuell	21. Jan. 2026