Horosa Skill MCP

MCP-сервер и CLI считают натальные карты, бацзы, цимэнь и таро офлайн, а агент толкует готовые данные, не выдумывая позиции

  • 509 ★ репозитория
  • Последний коммит
  • AGPL-3.0
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Установка скачивает с GitHub офлайн-движок (около 730 МБ) с Java и Node и запускает его локальным процессом на 127.0.0.1
  • Даты рождения, места и имена клиентов сохраняются в локальной базе SQLite и попадают в отчеты
  • Необязательный облачный слой Jev при включении отправляет обезличенный текст вопроса на серверы в США
Все причины и проверки

horace-maxwell/horosa-skill

Установка

Ручная установка

/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 расчетными инструментами: бацзы, цзывэй доушу, лю-яо, цимэнь дуньцзя, таро, западная астрология и китайский календарь

MCP-серверРасширенный доступ762Звезды репозитория

MCP-сервер считает карту Ба Цзы и истинное солнечное время по алгоритму, чтобы модель не выдумывала календарную арифметику

MCP-серверМинимальный доступ162Звезды репозитория

MCP-сервер считает карту Бацзы по дате рождения и отдает китайский календарь, так что агент не гадает иероглифы по памяти

MCP-серверРасширенный доступ436Звезды репозитория

Скилл для карты ба-цзы и смежных систем: солнечное время, совместимость, подбор дат и отчет со ссылками на классику

СкиллМинимальный доступ75Звезды репозитория

Скилл китайской нумерологии: скрипты считают карты Бацзы и Цзывэй, а агент разбирает результат по фиксированной методике.

СкиллМинимальный доступ67Звезды репозитория

Коротко о README

README начинается с главных свойств и быстрого старта через `uv`, затем дает таблицу подключения 25 клиентов и обзор техник. Дальше идут формат ответа, проверка данных перед расчетом, система доверия с карточкой основания, базой знаний и проверкой фактов, локальная база и отчеты. В конце описаны установка, качество и документация.

Бейдж для README

Сообщить о проблеме