Azan-MCP — времена намаза и исламский календарь
Azan-MCP
MCP-сервер с 34 инструментами: времена намаза по любой точке мира, календарь хиджры, азкары, закят и расчет наследства
- 383 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Расчеты идут по формулам и данным из пакета, ключей и внешних сервисов не требуется
Установка
- Работает в
Ручная установка
uvx azan-mcpБыстрый запуск из README. Файл настроек передают в переменной AZAN_CONFIG.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Расчеты идут по формулам и данным из пакета, ключей и внешних сервисов не требуется
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Azan-MCP — сервер на Python и FastMCP, который дает агенту справочные и расчетные инструменты по исламской практике. Он запускается командой `uvx azan-mcp`, работает локально и держит данные в самом пакете. Времена намаза считаются по астрономическому алгоритму Меуса для любой точки Земли: пять обязательных молитв и восход, 10 методов расчета и два мазхаба для времени Аср. Есть направление киблы, календарь на месяц, окна необязательных молитв Духа, Аввабин и Тахаджуд, а также текст азана на арабском и в транслитерации с вариантом для Фаджра. Время икамы считается от азана по заданным сдвигам. Другие модули переводят даты между григорианским календарем и хиджрой, называют даты Рамадана, ида и добровольных постов, выдают утренние и вечерние азкары и дуа по 15 темам со ссылкой на хадис и уровнем достоверности. Калькуляторы считают закят, порог нисаб по золоту и серебру, время сухура и ифтара и доли наследства по фараиду с учетом ауля. Отдельно доступны 99 имен Аллаха с поиском. Каждый ответ содержит блок meta с методом расчета, мазхабом и источником.
Для кого. Для мусульман, которым нужны точные времена намаза и расчеты в ассистенте, и для разработчиков приложений и агентов, не желающих сами писать астрономию и работу с часовыми поясами.
Подходит, если
- Нужно узнать времена пяти намазов на сегодня или на месяц для своего города и выбранного метода расчета
- Агент должен ответить, сколько минут осталось до следующего намаза
- Требуется перевести дату из григорианского календаря в хиджру и найти даты Рамадана и ида
- Нужно посчитать закят на деньги, золото или товары и сверить порог нисаб
- Приложению для мечети нужны время икамы со сдвигами и полный распорядок азанов на день
Не подходит, если
- Нужен религиозный вердикт по спорному вопросу: инструменты закята, фараида и календаря сами предупреждают, что нужно обратиться к квалифицированному ученому
- Нужно воспроизвести звук азана: сервер возвращает только текст, звука в ответе нет
- Нужны полные тексты Корана и сборников хадисов: сервер выдает только заложенные в него азкары, дуа и имена
- Нужен постоянный сдвиг икамы после перезапуска: set_iqama_offset действует только до перезапуска сервера, постоянные значения задают в файле конфигурации
Пример запроса к агенту
Покажи времена намаза в Казани на завтра по методу Muslim World League и сколько осталось до Магриба.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
AZAN_CONFIG- Путь к файлу azan-config.json с координатами, часовым поясом, методом расчета, мазхабом и сдвигами икамы.
Ограничения
Нужен Python 3.12 или новее. Место, часовой пояс, метод расчета, мазхаб и сдвиги икамы задаются в файле, путь к которому передают в переменной AZAN_CONFIG. Пример лежит в examples/azan-config.example.json. Для своего города настройте конфигурацию первым делом.
Автор сообщает о точности в пределах двух минут относительно IslamicFinder, однако независимой сверки в репозитории нет, а выбор метода и мазхаба меняет итоговое время, поэтому с местной мечетью или календарем стоит сверить результат. Каждый дуа и зикр снабжен хадисом и уровнем достоверности, при этом проект пока имеет версию 0.1.0.
Для закята и расчета наследства инструмент считает по формулам, цену золота и серебра задаете вы сами. Доступность из России при подготовке карточки не проверялась.
Как отключить. Удалите блок azan из конфигурации MCP-клиента и перезапустите клиент. Файл настроек удалите вместе с блоком, если он больше не нужен.
Частые вопросы
Как поставить Azan-MCP в Claude Desktop?
Добавьте в `claude_desktop_config.json` сервер azan с командой `uvx` и аргументом `azan-mcp`. В env задайте AZAN_CONFIG с путем к файлу настроек. Других установок не нужно: ни npm, ни Docker.
Какие методы расчета времени намаза поддерживает Azan-MCP?
Десять: Умм аль-Кура в Мекке, Всемирная исламская лига, ISNA, египетский, Карачи, Тегеран, Кувейт, UOIF во Франции, Исна Ашари и Мухаммадия. Для Асра выбирается ханафитский или шафиитский мазхаб. Полный список с углами Фаджра и Иши возвращает инструмент list_calculation_methods.
Можно ли доверять расчету закята и наследства?
Инструменты считают по формулам: 2,5% над порогом нисаб, нисаб как 85 граммов золота и 595 граммов серебра, доли по Корану 4:11–12 точными дробями. В каждом ответе есть напоминание проконсультироваться с квалифицированным ученым.
Откуда у дуа и азкаров берутся источники?
Каждая запись хранит ссылку на хадис и уровень достоверности: высокий для Бухари и Муслима, средний для сборников Сунан. Это данные, заложенные в пакет, поиска в сети сервер не выполняет.
Сервер хранит где-нибудь мое местоположение?
Нет. Координаты лежат в вашем файле конфигурации на вашей машине, расчет идет по алгоритму из пакета, а изменение сдвига икамы через set_iqama_offset живет только в памяти до перезапуска.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыOpenFate Bazi MCP — расчет карты Ба Цзы
OpenFate Bazi MCP
MCP-сервер считает карту Ба Цзы и истинное солнечное время по алгоритму, чтобы модель не выдумывала календарную арифметику
Passage of Time MCP дает модели текущее время и семь инструментов для расчета интервалов, сдвигов и контекста даты, чтобы она не считала время в уме
MCP-сервер считает карту Бацзы по дате рождения и отдает китайский календарь, так что агент не гадает иероглифы по памяти
Официальный плагин и MCP-сервер Astravue: 87 инструментов для задач, проектов, учета времени и 8 готовых скиллов планирования.
MCP-сервер и CLI считают натальные карты, бацзы, цимэнь и таро офлайн, а агент толкует готовые данные, не выдумывая позиции
MCP сервер для календаря macOS: агент создает, находит и меняет события естественным языком
Коротко о README
README делит 34 инструмента по шести модулям и приводит таблицу каждого с описанием. Отдельно описаны принципы проекта: точность расчета, подтвержденные источники, блок meta в ответах и напоминание об ученом. Показаны быстрый запуск, настройка для Claude Desktop, пример файла конфигурации и запуск тестов.