English Français العربية

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

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.adelpro/quran-search-engine-mcp؟

  • 🔌 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package quran-search-engine-mcp
Claude Code 
claude mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp@0.2.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "quran-search-engine-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "quran-search-engine-mcp@0.2.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Quran Search Engine MCP
  2. Public endpoint
  3. Features
  4. Install
  5. Documentation
  6. Quick start (HTTP)
  7. Quick start (Docker)
  8. Requirements
  9. License
  10. Contact

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.

ResourceURL
MCP server (Streamable HTTP)https://mcp.quran.us.kg/
Health checkhttps://mcp.quran.us.kg/health
Status pagehttps://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>

الأسئلة الشائعة

ما هو io.github.adelpro/quran-search-engine-mcp؟

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

كيف أثبّت io.github.adelpro/quran-search-engine-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add quran-search-engine-mcp -- npx -y quran-search-engine-mcp@0.2.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.adelpro/quran-search-engine-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.adelpro/quran-search-engine-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.adelpro/quran-search-engine-mcp؟

ينشره adelpro. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.