Fortune-telling calculus wrapped in Next.js and MCP

What it does

Taibu is a TypeScript project that implements a sprawling catalogue of traditional divination systems—Chinese (Bazi, Ziwei Doushu, Qi Men Dun Jia, Liu Ren, and others) and Western (tarot, astrology, MBTI)—as calculation engines. It wraps them in a Next.js web interface and exposes them through a public Model Context Protocol (MCP) server and a standalone taibu-core npm package. Users can generate natal charts or pull tarot cards; agents can invoke the same logic via HTTP streams without API keys.

The interesting bit

The README treats these systems like deterministic rule engines, listing technical specifics such as “51 kinds of Shensha” and “Ziwei flying star analysis” alongside Docker ports. The MCP server implements the 2026-07-28 protocol draft, so your LLM can debate your Bazi chart strength via structured tool calls. It is, in effect, a domain-specific calculation engine for metaphysics.

Key highlights

• Exposes more than a dozen divination systems—including Bazi, Qi Men Dun Jia, Da Liu Ren, and tarot—as MCP tools with typed inputs and outputs.
• Core calculation packages (taibu-core, mcp, mcp-server) ship under the MIT license; the full-stack web app and remaining code are AGPL-3.0-only.
• Supports protocol features like explicit timezone handling, true solar time, and reverse pillar lookup (converting a Bazi chart back to candidate birth windows).
• Bundles a Next.js 16 web UI with Supabase backend, plus iOS and Android clients, for end-user access to the same engines.
• The public MCP endpoint uses streamable HTTP and requires no API key or OAuth setup for stateless clients.

Caveats

• The MCP server targets the 2026-07-28 protocol draft, which is explicitly noted as a future release; expect drift as the spec finalizes.
• The web application layer is AGPL-3.0-only, so embedding its frontend or backend in proprietary SaaS without source release would violate that license.
• The project is primarily documented in Chinese; while an English README exists, the feature depth and interface are Sino-centric.

Verdict

Developers building AI agents for the Chinese-speaking market—or anyone fascinated by modeling complex cultural rule systems in TypeScript—should look here. If you have no interest in divination, metaphysics, or MCP tool proliferation, this is safely skippable.