Criei um Motor de Astrologia Chinesa e Integrei em Ferramentas de Codificação de IA

TL;DR: Eu construí shunshi-bazi-core — uma biblioteca TypeScript que calcula gráficos dos Quatro Pilares do Destino Chinês (八字 / 四柱推命 / 사주팔자) com correção de tempo solar verdadeiro. Em seguida, eu a envolvi como um servidor MCP para Claude Desktop / Cursor / Cline, e uma habilidade Claude Code para o CLI. Tudo é licenciado sob MIT.

O que é Bazi?

Bazi (八字, literalmente "oito caracteres") é um sistema da metafísica chinesa que mapeia a data e hora de nascimento de uma pessoa em um gráfico de troncos celestiais e ramos terrestres. Pense nisso como o equivalente chinês de um gráfico natal em astrologia ocidental — exceto que opera em um sistema de calendário completamente diferente (o ciclo sexagenário) e tem sua própria estrutura analítica envolvendo os Dez Deuses (十神), os Cinco Elementos (五行) e Dayun (大运, períodos de destino de dez anos).

É conhecido como 四柱推命 (Shichū Suimei) no Japão e 사주팔자 (Saju Palja) na Coreia. Centenas de milhões de pessoas em toda a Ásia Oriental consultam leituras de Bazi — é uma das formas de adivinhação mais amplamente praticadas no mundo.

O Problema: Por que as Bibliotecas Existentes Não Funcionam

Quando comecei a construir Shunshi.AI (uma plataforma de leitura de Bazi alimentada por IA), eu pesquisei todas as bibliotecas Bazi de código aberto que consegui encontrar em JavaScript, Python e TypeScript. Todas tinham pelo menos um desses problemas:

1. Sem Correção de Tempo Solar Verdadeiro

Este é o grande problema. Os gráficos de Bazi são baseados em tempo solar, não em tempo de relógio. Se você nasceu em Urumqi (oeste da China, UTC+8) às 14:00 no horário do relógio, seu tempo solar real é mais próximo de 12:00 — uma diferença de duas horas que desloca todo o pilar da hora e muda completamente a leitura.

A maioria das bibliotecas simplesmente aceita o horário do relógio como está. Isso gera gráficos errados para qualquer um que nasceu longe do meridiano padrão de seu fuso horário: oeste da China, Hokkaido, costa oeste dos EUA, Europa Ocidental...

2. O Problema da Meia-Noite (子時分日)

O que acontece quando alguém nasce às 23:30? Isso é "hoje" ou "amanhã" em termos de Bazi?

Diferentes escolas discordam (早子時 vs 晚子時). A maioria das bibliotecas não permite que você escolha — elas silenciosamente escolhem uma convenção, e você descobre a discrepância apenas quando seu gráfico não concorda com o de um profissional.

3. Sem Linha de Base de Paridade

Você calcula um gráfico, compara com um serviço pago, obtém respostas diferentes. Quem está certo? Sem casos de teste padrão contra ferramentas de referência autorizadas, não há como saber.

A Solução: shunshi-bazi-core

Eu extraí o motor de cálculo do backend de produção do Shunshi.AI e publiquei como uma biblioteca TypeScript independente:

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,      // 1 = masculino, 0 = feminino
  city: '广州',    // ativa a correção de tempo solar verdadeiro
});

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

O que você recebe de volta:

• Quatro Pilares com troncos celestiais, ramos terrestres e troncos ocultos
• Dez Deuses (十神) para cada pilar
• Notas dos Cinco Elementos com porcentagens
• 40+ Shensha (神煞, estrelas especiais) por pilar
• Dayun (大运, períodos de destino de dez anos) com o período atual marcado
• Nayin (纳音), Kongwang (空亡), e Xing-Chong-He-Hui (刑冲合会)
• Correção de tempo solar verdadeiro — basta passar um nome de cidade ou longitude/latitude

A biblioteca é testada em paridade contra o backend Python do Shunshi.AI e os cálculos de relação do cantian-tymext em 5 casos de teste padrão cobrindo casos extremos como nascimentos às 23:48 e limites do festival da primavera.

Integrando com Ferramentas de IA

Um motor de cálculo é útil, mas a verdadeira mágica acontece quando agentes de IA podem chamá-lo. Eu construí três camadas de integração:

Camada 1: Servidor MCP (Claude Desktop / Cursor / Cline)

npx -y shunshi-bazi-mcp

Adicione isso à sua configuração do Claude Desktop:

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

Agora você pode perguntar ao Claude em linguagem natural:

"Calcule o gráfico de Bazi para alguém nascido em 24 de março de 1990 às 10:28 AM em Guangzhou, masculino."

Claude chama a ferramenta MCP, obtém o JSON completo do gráfico e lhe fornece uma resposta profissional.