Alfanous - Quranic Search Engine

Alfanous - Quranic Search Engine

Alfanous-teamLGPL-3.0
285 звёзд91 форков
Alfanous — поисковый MCP-сервер для Священного Корана. Ищет аяты на арабском языке, транслитерации Баквалтера и по метаданным: суры, джузы, саджда. Разработчики используют его, чтобы добавить в AI-ассистента точный поиск по тексту Корана. Запросы строятся на простом языке или с помощью логических операторов. Сервер работает через протокол MCP по stdio, поэтому легко интегрируется в Claude Desktop, Cursor и другие совместимые клиенты.
Search
Открыть на GitHub

Установка

uvx alfanous3-mcp

Характеристики

Общее

  • СтатусСообщество
  • РазработчикAlfanous-team
  • ЛицензияLGPL-3.0

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Поиск аятов по точной фразе, слову или шаблону (*).
  • Комбинация условий: AND (+), OR (|), NOT (-).
  • Фильтрация поиска по суре (sura_id), джузу (juz), наличию саджда (sajda).
  • Запросы на арабском и в латинской транслитерации Баквалтера (например, Allh).
  • Автоматическое исправление опечаток в запросах через correct_query.
  • Подсказки при вводе (suggest action).
  • Фасетный поиск — группировка результатов по сурам, джузам, темам.
  • Получение метаданных: информация о переводах, recitations, лингвистические данные.
  • Работа как Python-библиотека (alfanous3) или REST API.

Как подключить

  1. Установите MCP-сервер через uvx:

    uvx alfanous3-mcp

  2. Добавьте конфигурацию для вашего MCP-клиента. Пример для Claude Desktop:

    { "mcpServers": { "alfanous": { "command": "uvx", "args": ["alfanous3-mcp"] } } }

  3. Перезапустите клиент. Сервер готов к работе без дополнительных ключей и настроек.

Примеры запросов

  • «Найди аят с точной фразой الحمد لله и покажи его транслитерацию.»
  • «Покажи все аяты из суры Йа Син (36-я сура).»
  • «Какие аяты содержат слово نبي в джузе 30?»
  • «Сгруппируй результаты поиска слова ملك по сурам.»

Технические детали

  • Компонент: alfanous3-mcp
  • Язык: Python
  • Транспорт: stdio
  • Лицензия: LGPL-3.0
  • Категория: search
  • Совместимость: Claude Desktop, Cursor, другие MCP-хосты

Поделиться