bazi-reader-mcp

🇨🇳 中国八字 (Четыре столпа судьбы) ・ 🇯🇵 四柱推命 (Сичу-суймэй) ・ 🇰🇷 사주팔자 (Саджу-пальджа)

Вычислительный движок (и MCP-сервер), лежащий в основе Shunshi.AI / 顺时, с открытым исходным кодом.

🇯🇵 Японским разработчикам: Это вычислительный движок + MCP-сервер для китайского «八字 (bāzì)», известного в Японии как 四柱推命 (Сичу-суймэй). Вы можете рассчитывать Четыре столпа / Десять божеств / Большие удачи / Баланс пяти элементов на основе даты, времени и места рождения. Поддерживается коррекция по истинному солнечному времени (уравнение времени), и его можно вызывать напрямую из AI-агентов (Claude / Cursor / Cline и др.).

🇰🇷 Корейским разработчикам: Это вычислительный движок + MCP-сервер для китайского «八字 (bāzì)», известного в Корее как 사주팔자 (Саджу-пальджа). Вы можете рассчитывать Саджу / Десять божеств / Большие удачи / Баланс пяти элементов на основе даты, времени и места рождения. Поддерживается коррекция по истинному солнечному времени, и его можно использовать напрямую в AI-агентах (Claude / Cursor / Cline и др.).

Этот репозиторий представляет собой монорепозиторий с двумя опубликованными npm-пакетами:

Оба пакета используют один и тот же вычислительный движок, который обеспечивает работу продакшн-бэкенда Shunshi.AI. Оба проходят проверку на идентичность результатов при каждом релизе.

Почему это существует

Большинство существующих библиотек с открытым исходным кодом для Ба-цзы (на любом языке) имеют как минимум одну из следующих проблем:

1. Отсутствие коррекции по истинному солнечному времени. Время по часам используется как есть, что дает неверные карты для рождений вдали от стандартного меридиана часового пояса (Синьцзян / Хэйлунцзян / Западное побережье США / Хоккайдо). Ошибка в 30 минут сдвигает весь столп часа.

2. Непоследовательная обработка 子时 (часа Крысы). Некоторые библиотеки относят время 23:00-23:59 к столпу дня «вчера», другие — к «завтра». Если вы не сделаете выбор, ваши карты будут расходиться с профессиональными справочными инструментами.

3. Отсутствие эталона для сравнения. Вы рассчитываете карту локально, сравниваете с платным сервисом, получаете другие цифры и не имеете возможности понять, кто прав.

4. Только необработанные данные, отсутствие многоязычного контекста. Вывод ориентирован на китайский язык, его сложно интегрировать в AI-ассистенты на японском/корейском/английском языках.

shunshi-bazi-core + shunshi-bazi-mcp решают все четыре проблемы:

• ✅ Встроенная коррекция истинного солнечного времени, включена по умолчанию (просто передайте city или longitude/latitude).

• ✅ По умолчанию sect=1 (23:00 = столп дня следующего дня), что соответствует 问真八字.

• ✅ Проверено на идентичность с Python-бэкендом Shunshi.AI (5/5 золотых случаев) и calculateRelation() из cantian-tymext (5/5 по подмножеству парных взаимодействий 刑冲合会).

• ✅ Многоязычная доступность через ключевые слова (bazi / 八字 / 四柱推命 / 사주팔자 / saju / shichu-suimei), чтобы разработчики из Японии, Кореи и англоязычных стран могли найти пакет.

Быстрый старт

Если вы встраиваете расчет Ба-цзы в свое приложение

npm install shunshi-bazi-core

import { getBaziChart } from 'shunshi-bazi-core';

const chart = getBaziChart({
  year: 1990, month: 3, day: 24, hour: 10, minute: 28,
  gender: 1,           // 0 = 女, 1 = 男
  city: '广州',         // triggers true solar time correction
});

console.log(chart.八字.四柱);          // "庚午 己卯 戊子 丁巳"
console.log(chart.真太阳时?.修正分钟); // -33.85 (minutes of correction applied)

→ Полный API и справочник по выводу: packages/bazi-core/README.md

Если вы хотите, чтобы Claude / Cursor / Cline рассчитывали карты Ба-цзы

Добавьте это в свою конфигурацию MCP (например, claude_desktop_config.json):

{
  "mcpServers": {
    "shunshi-bazi": {
      "command": "npx",
      "args": ["-y", "shunshi-bazi-mcp"]
    }
  }
}

Затем перезапустите клиент и спросите своего AI-агента на естественном языке:

"Помоги мне рассчитать Ба-цзы для мальчика, родившегося 24 марта 1990 года в 10:28 утра в Гуанчжоу."

→ Полная документация по инструментам MCP, альтернативные конфигурации клиентов, устранение неполадок: packages/bazi-mcp/README.md

Структура репозитория

bazi-reader-mcp/
├── package.json                 # npm workspace root (private)
├── tsconfig.base.json           # shared TypeScript config
├── LICENSE                      # MIT
├── README.md                    # you are here
└── packages/
    ├── bazi-core/               # → publishes as "shunshi-bazi-core"
    │   ├── src/
    │   │   ├── index.ts
    │   │   └── lib/{bazi,relations,shensha,solarTime,cityCache}.ts
    │   ├── tests/{parity,relations-vs-cantian,smoke}.ts
    │   ├── package.json
    │   └── README.md
    └── bazi-mcp/                # → publishes as "shunshi-bazi-mcp"
        ├── src/{mcp,stdio}.ts
        ├── tests/smoke-stdio.ts
        ├── package.json
        └── README.md

Разработка

# install deps for both packages
npm install

# build both packages
npm run build

# run bazi-core tests (parity + relations-vs-cantian)
npm test

# run the MCP server locally via tsx (no build required)
npm run dev:mcp

# stdio smoke test for the MCP (spawns the built dist/stdio.js)
cd packages/bazi-mcp && npm run smoke

Покрытие тестами

• packages/bazi-core/tests/parity.test.ts — 5 золотых случаев, размеченных вручную по скриншотам 问真八字, перекрестно проверенных с Python-бэкендом Shunshi.AI по параметрам 四柱 / 十神 / 空亡 / 纳音 / 藏干.

• packages/bazi-core/tests/relations-vs-cantian.test.ts — совпадение 5/5 с calculateRelation() из cantian-tymext по 刑冲合会 (подмножество парных взаимодействий: 合 / 冲 / 刑 / 害 / 破 / 克).

• packages/bazi-mcp/tests/smoke-stdio.ts — сквозное рукопожатие stdio + tools/list + tools/call, проверяет реальный вывод 四柱 и блок атрибуции 数据来源. Использует реальный клиент MCP SDK, поэтому выполняет тот же путь кода, что и Claude Desktop.

Связанные проекты

• tyme4ts от 6tail — примитивы лунно-солнечного календаря на TypeScript, на которых построена эта библиотека.

• cantian-ai/bazi-mcp — первопроходцы в области MCP для Ба-цзы с открытым исходным кодом. Мы используем их cantian-tymext в качестве dev-зависимости для тестирования идентичности отношений. Эти два MCP дополняют, а не конкурируют друг с другом — мы выбрали другие настройки по умолчанию (sect=1, истинное солнечное время включено по умолчанию), основываясь на том, что соответствует профессиональной практике в китайскоязычном мире.

О Shunshi.AI

🌐 Веб-сайт: https://shunshi.ai 🐦 X / Twitter: @shunshiai2026 🚀 Product Hunt: Shunshi.AI

Shunshi.AI (顺时) — это платформа для чтения Ба-цзы на базе ИИ, поддерживающая английский, китайский (中文), японский (日本語) и корейский (한국어) языки. Бесплатно для пробы, кредитная карта не требуется.

Мы открыли исходный код вычислительного движка, лежащего в основе нашего продакшн-бэкенда, чтобы:

• Любой разработчик мог рассчитывать карты Ба-цзы с той же точностью, что и наш платный продукт.

• Краевые случаи 真太阳时 / 子时 были решены раз и навсегда, вместо того чтобы каждый проект решал их неправильно по-своему.

• Разработчики из Японии, Кореи и англоязычных стран наконец получили библиотеку на TypeScript, которая использует их терминологию (四柱推命 / 사주팔자).

Лицензия

MIT © 2026 Shunshi.AI