Horosa Skill MCP
MCP-сервер и CLI считают натальные карты, бацзы, цимэнь и таро офлайн, а агент толкует готовые данные, не выдумывая позиции
- 509 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Установка скачивает с GitHub офлайн-движок (около 730 МБ) с Java и Node и запускает его локальным процессом на 127.0.0.1
- Даты рождения, места и имена клиентов сохраняются в локальной базе SQLite и попадают в отчеты
- Необязательный облачный слой Jev при включении отправляет обезличенный текст вопроса на серверы в США
Установка
- Работает в
Ручная установка
/plugin marketplace add Horace-Maxwell/horosa-skillДальше выполните `/plugin install horosa@horosa-skill` и один раз поставьте движок командой из сообщения `runtime.not_installed`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установка скачивает с GitHub офлайн-движок (около 730 МБ) с Java и Node и запускает его локальным процессом на 127.0.0.1
- Даты рождения, места и имена клиентов сохраняются в локальной базе SQLite и попадают в отчеты
- Необязательный облачный слой Jev при включении отправляет обезличенный текст вопроса на серверы в США
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Horosa Skill дает агенту MCP-сервер и CLI для расчета астрологических карт и китайских систем гадания на своем компьютере. В наборе больше ста техник: западная астрология с натальной картой, транзитами, прогрессиями, первичными дирекциями, хорарной и элективной астрологией, астрокартографией и синастрией, затем бацзы, цзывэй доушу, да лю жэнь, цимэнь дуньцзя, тай и, цзинькоуцзюэ, лю яо, таро, китайский календарь и 14 систем шэньшу. После установки расчеты идут в локальном движке, а даты рождения и места по умолчанию не уходят в сеть. Перед расчетом сервер проверяет, хватает ли данных. Если технике нужны время, место, часовой пояс, пол или тип вопроса, он останавливает агента и возвращает вопрос, который можно переслать человеку. Каждый ответ приходит в одном формате вместе с карточкой основания: какая техника, чья школа, все ли разделы получены. Инструмент `horosa_hecan` запускает несколько техник на один вопрос и отдает шаблон сравнения, в котором расхождения надо раскрывать, а усреднять их нельзя. Результаты сохраняются в локальную базу SQLite с полнотекстовым поиском, из них одной командой собираются отчеты DOCX, PDF и JSON. Свои заметки можно положить в локальную базу знаний, и они попадут в контекст агента вместе с расчетом.
Для кого. Астрологам и энтузиастам, которые просят агента растолковать карту, и разработчикам ботов, которым нужен надежный расчет вместо позиций планет из памяти модели.
Подходит, если
- Нужна натальная карта или транзиты на дату, а планеты и дома агент не должен угадывать
- Бацзы или цзывэй доушу по дате рождения: движок считает столпы и дворцы, агент только толкует
- Один вопрос надо разобрать сразу несколькими техниками: `horosa_hecan` сводит их и показывает расхождения
- Историю консультаций надо хранить и находить по имени, технике и дате в локальной базе
- Результат нужен отчетом DOCX или PDF с оглавлением и номерами страниц
Не подходит, если
- Решение касается здоровья, денег или судьбы человека: расчет точен, но толкование техник традиционное и научной проверки не имеет
- Нужен публичный сервис для многих клиентов: режим streamable-http идет без TLS и требует токен, его придется прятать за обратным прокси
- Данные клиентов нельзя хранить на своем компьютере: консультации сохраняются в локальной базе SQLite
- Нужен только один расчет по бацзы: проще взять узкий MCP-сервер Bazi MCP
Пример запроса к агенту
Построй натальную карту на 12 мая 1990, 14:30, Москва, и отдельно посчитай бацзы на ту же дату, затем сопоставь выводыMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
HOROSA_RUNTIME_ROOT- Каталог движка, в Windows нужен путь только из ASCII.
HOROSA_MCP_TOKENсекрет- Токен для режима streamable-http, обязателен при привязке к 0.0.0.0.
HOROSA_JEV_API_KEYсекрет- Ключ необязательного облачного слоя Jev, по умолчанию слой выключен.
Ограничения
- Офлайн-движок выпущен только для macOS (Apple Silicon) и Windows (x64), в Linux работает шлюз MCP, а движок придется держать на другой машине.
- Путь к движку должен состоять из символов ASCII. Если в Windows имя пользователя написано по-русски или по-китайски, задайте `HOROSA_RUNTIME_ROOT=C:\horosa`.
- Канал PyPI пока не открыт: `uvx` берет сборку из релиза на GitHub, версия закреплена в адресе.
- Встроенная проверка сверяет факты в толковании с данными карты (позиции, столпы, расклады), а правильность предсказаний она не оценивает.
Как отключить. Уберите сервер из конфигурации клиента, для Claude Code командой `claude mcp remove horosa`, а плагин снимите через `/plugin`. Движок удаляет команда `uv run horosa-skill uninstall`: по умолчанию она только печатает список удаляемого, с флагом `--yes` выполняет, а пользовательские данные трогает лишь с `--purge-data`.
Частые вопросы
Как подключить Horosa Skill к Claude Code?
Через плагин: `/plugin marketplace add Horace-Maxwell/horosa-skill`, затем `/plugin install horosa@horosa-skill`. Один раз поставьте движок командой `uv run --directory "<папка плагина>" horosa-skill install`, точный путь покажет ошибка `runtime.not_installed`. Вместо плагина работает `uv run horosa-skill setup --client claude-code`.
Уходят ли даты рождения в сеть?
По умолчанию нет: расчеты и база лежат на вашем компьютере. Исключение составляет необязательный облачный слой Jev (`HOROSA_JEV`, по умолчанию выключен). При включении он отправляет обезличенный текст вопроса, где даты, время, координаты и названия мест заменены метками.
Что делать, если инструменты не появились в клиенте?
Запустите `uv run horosa-skill client check`: команда читает, что реально записано в конфигурациях клиентов, и указывает на нераскрытые подстановки, перенесенные папки и таймауты Codex. Клиенты с графическим интерфейсом не наследуют PATH оболочки, поэтому `client config` пишет абсолютные пути.
Сколько инструментов получит клиент?
Полный набор из 125 инструментов получают Claude Code и клиенты вроде Open WebUI. В VS Code, JetBrains Junie и плагинах Agent Plugins v1 подключается сокращенный набор из 11 инструментов.
Сколько места и каких программ нужно для установки?
Нужен `uv`, он сам готовит Python 3.12 или новее. На диске стоит оставить около 5 ГБ: движок скачивается примерно на 730 МБ и занимает около 2 ГБ после распаковки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер с 15 расчетными инструментами: бацзы, цзывэй доушу, лю-яо, цимэнь дуньцзя, таро, западная астрология и китайский календарь
OpenFate Bazi MCP — расчет карты Ба Цзы
OpenFate Bazi MCP
MCP-сервер считает карту Ба Цзы и истинное солнечное время по алгоритму, чтобы модель не выдумывала календарную арифметику
MCP-сервер считает карту Бацзы по дате рождения и отдает китайский календарь, так что агент не гадает иероглифы по памяти
Скилл для карты ба-цзы и смежных систем: солнечное время, совместимость, подбор дат и отчет со ссылками на классику
Скилл китайской нумерологии: скрипты считают карты Бацзы и Цзывэй, а агент разбирает результат по фиксированной методике.
MCP-сервер с 34 инструментами: времена намаза по любой точке мира, календарь хиджры, азкары, закят и расчет наследства
Коротко о README
README начинается с главных свойств и быстрого старта через `uv`, затем дает таблицу подключения 25 клиентов и обзор техник. Дальше идут формат ответа, проверка данных перед расчетом, система доверия с карточкой основания, базой знаний и проверкой фактов, локальная база и отчеты. В конце описаны установка, качество и документация.