taibu

<div align="center"> <img src="public/favicon.svg" alt="tai bu" width="80" height="80"> # Tool List **Integrating Traditional Divination Culture with AI** [](https://nextjs.org/) [](https://www.typescriptlang.org/) [](https://tailwindcss.com/) [](https://supabase.com/) [](https://vercel.com/) Language: | [English](README.en.md) [Online Experience](https://www.mingai.fun) · [Report Issues](https://github.com/hhszzzz/taibu/issues) </div> --- ## Product Highlights - **Multiple Divination Systems** - Eight Characters, Six Lines, Zi Wei Dou Shu, Qi Men Dun Jia, Da Liu Ren, Mei Hua Yi Shu, Tarot, MBTI, Face Reading, Palm Reading, Synastry, Zhou Gong Dream Interpretation - **AI Intelligent Analysis** - Supports exporting divination system text for AI analysis, multi-model support, in-depth reasoning, visual recognition - **MCP Server** - Supports Model Context Protocol (MCP), can be called directly in MCP-enabled clients - **History Records, Knowledge Base, and @ Mention** - Supports storing all divination system records, can incorporate divination systems into personal knowledge base, explicit reference to divination system data sources - **AI Personalization** - Expression style/user image/custom instructions + context, prompt word budget visualization - **Multi-End Experience** - Web + iOS/Android clients - **Community and Incentives** - Divination records, anonymous discussion, sign-in incentives --- ## Divination Function Preview | Function Module | Core Features | | :----: | :--- | | **Eight Characters** | · True solar time, solar and lunar calendar, immediate charting, four pillars charting<br/>· Five elements, heavenly stems and earthly branches, ten gods, hidden stems, star luck, sound, and divine killers (51 kinds), twelve long lives, punishment and harm combination and impact<br/>· Heavenly stem combination, earthly branch semi-combination, earthly branch three meetings<br/>· Grand fortune, luck, month luck, day luck<br/>· Traditional analysis, blind school analysis | | **Zi Wei Dou Shu** | · Twelve palace positions, three sides and four positives<br/>· Main star, auxiliary star, miscellaneous star, four transformations (including self-transformation)<br/>· Life master star/body master star, small limit, doctor twelve stars<br/>· Prosperity and decline, limit/ luck/ month/ day/ hour luck analysis<br/>· Flying star analysis (flying transformation, self-transformation, four transformations falling palace, three sides and four positives) | | **Qi Men Dun Jia** | · Nine palaces, heaven and earth plate, eight doors, nine stars, eight gods<br/>· Value symbol value makes, divination type, bureau number<br/>· Pattern judgment (good/ bad), empty and dying, postal horse, into tomb, prosperity and decline<br/>· Rotating plate arrangement, disassembling and supplementing/Mao Shan bureau method<br/>· Explicit time zone support | | **Da Liu Ren** | · Heaven and earth plate, four lessons, three transmissions<br/>· Heavenly general (twelve gods general), hidden stem<br/>· 49 kinds of divine killers, lesson body classification<br/>· Twelve long lives, five elements prosperity and decline, establishment and removal of twelve gods<br/>· Explicit time zone, support for life/ line | | **Six Lines** | · Coin divination, quick divination, selected divination, time divination, digital divination<br/>· Yao change clear movement, hidden movement<br/>· Divination decision, Yao decision, image decision<br/>· Use god, original god, volt god, hate god<br/>· Empty and dying · World should, prosperity and decline state, punishment and impact combination and harm<br/>· Mutual diagram, wrong diagram, comprehensive diagram<br/>· Response period prediction | | **Mei Hua Yi Shu** | · Year, month, date, time start divination, object number/ sound number, word occupation, ruler size, direction class image<br/>· Two numbers/ three numbers report number extension method<br/>· Original diagram, mutual diagram, change diagram, wrong diagram, comprehensive diagram, moving Yao<br/>· Body diagram/ use diagram, body use life and death, month order prosperity and decline, response level<br/>· Response period clue, qualitative luck judgment | | **Tarot** | · 9 kinds of card arrays: single card, three-card array, love card array, Celtic cross, horse hoof, choice, mind and spirit, situation, yes/ no<br/>· Reversal judgment, 78 complete card surface interpretation, beautiful card<br/>· Constellation/ element correspondence, digital divination (personality card/ soul card/ year card)<br/>· Daily fortune guidance | | **Synastry** | · Lovers, business, parent-child<br/>· Future fortune line<br/>· Communication suggestions | | **Face Reading, Palm Reading** | · Heavenly yard, nose phase, eye phase, mouth phase<br/>· Life line, wisdom line, career line, love line | | **Fortune Center** | · Daily, monthly fortune analysis based on birth chart<br/>· Daily almanac (including direction system, 12 hours luck and unlucky, twenty-eight star hosts)<br/>· Future fortune line | | **MBTI Personality Test** | · 90+ personality test questions<br/>· Comprehensive AI analysis personality | | **High AI Integration** | · Comprehensive analysis based on past divination<br/>· Complete analysis of divination system<br/>· Knowledge base, attachment, search<br/>· Support AI conversation mentioning all divination systems<br/>· Annual divination report | --- ## MCP The tool provides MCP, which can be called directly in MCP-enabled clients. ### Quick Configuration Add the following content to the configuration to use: ```json { "mcpServers": { "taibu": { "command": "npx", "args": ["-y", "taibu-mcp"] } } } ``` ### Supported Tools | Tool | Function | Question Examples | | --- | --- | --- | | `bazi` | Eight Characters (supporting solar/ lunar calendar, 51 kinds of divine killers, heavenly stem combination, earthly branch semi-combination/ three meetings, fetal element/ life palace) | "I was born on May 15, 1990, at 15:00, please help me chart" | | `bazi_pillars_resolve` | Eight Characters reverse query (four pillars → birth time candidates, 1900-2100) | "My eight characters are Bing Wu Geng Yin Bing Chen, please help me analyze" | | `bazi_dayun` | Eight Characters grand fortune calculation (ten-year fortune cycle, luck details, Tai Sui marking, small fortune) | AI will automatically analyze your eight characters and call calculation | | `ziwei` | Zi Wei Dou Shu charting (including life master star/ body master star, small limit, doctor 12 stars, three sides and four positives) | "I was born on the 8th day of the 4th lunar month in 1990, please arrange Zi Wei chart" | | `ziwei_horoscope` | Zi Wei fortune limit (limit/ small limit/ luck/ month/ day/ hour luck, luck star) | "Help me see the Zi Wei fortune limit in 2026" | | `ziwei_flying_star` | Zi Wei flying star analysis (flying transformation/ self-transformation/ four transformations falling palace/ three sides and four positives) | "Analyze the flying star of my life palace" | | `liuyao` | Six Lines divination (supporting divination/ autonomous divination/ time divination/ digital divination, including mutual diagram/ wrong diagram/ comprehensive diagram) | "I want to divinate my career luck this year, please help me start divination and analysis" | | `meihua` | Mei Hua Yi Shu (supporting year, month, date, time start divination, object number/ sound number, word occupation, ruler size, direction class image, two numbers/ three numbers report number) | "Now start a divination, use Mei Hua Yi Shu to see if this cooperation can be successful" | | `tarot` | Tarot drawing (9 kinds of card arrays, 78 complete card surface, independent reversal keyword, constellation/ element correspondence) | "Please draw a Tarot card for me, about recent love luck" | | `almanac` | Almanac query (including direction system, 12 hours luck and unlucky, twenty-eight star hosts) | "How is today's almanac? Is it suitable for marriage?" | | `astrology` | Western astrology birth chart and luck (birth chart three giants, life master star, major luck trigger) | "Help me see the astrology luck focus during this period" | | `qimen` | Qi Men Dun Jia charting (nine palaces, eight doors, nine stars, eight gods, value symbol value makes, explicit time zone) | "Use Qi Men to see if it's smooth to discuss cooperation today" | | `taiyi` | Taiyi nine-star observation (external time and space environment, nine-star array, energy interaction) | "Use Taiyi nine-star to see the progress of this project" | | `daliuren` | Da Liu Ren charting (four lessons, three transmissions, heaven and earth plate, god general, explicit time zone) | "Use Da Liu Ren to see the result of this matter" | | `xiaoliuren` | Xiao Liu Ren divination and measurement (start divination result, palace position drop point, core breaking clue) | "Use Xiao Liu Ren to see if it's smooth to travel today" | ### SDK If you want to call the calculation engine directly in your Node.js project (without MCP protocol), you can use the core library: ```bash npm install taibu-core ``` See [taibu-core npm page](https://www.npmjs.com/package/taibu-core) for details. --- ## Quick Start ### Docker Deployment Support three methods: ```bash # Prepare environment variables (initial) cp .env.example .env # 1) One-click deployment: start Web + MCP at the same time docker compose up -d --build # 2) Deploy Web only docker compose -f docker-compose.web.yml up -d --build # 3) Deploy MCP Server only docker compose -f docker-compose.mcp.yml up -d --build ``` Default port: - Web: `3000` ([http://localhost:3000](http://localhost:3000)) - MCP: `3001` ### Development Environment Deployment Environment requirements: - Node.js 18+ - pnpm (recommended) / npm / yarn ```bash # Clone project git clone git@github.com:hhszzzz/taibu.git cd taibu # Install dependencies pnpm install # Configure environment variables cp .env.example .env # Edit .env and fill in necessary API Keys # Start development server pnpm dev ``` Visit [http://localhost:3000](http://localhost:3000) to view the application. --- ## Contribution Welcome to submit Issues and Pull Requests! --- ## License This repository uses a mixed license: - `packages/core` - `packages/mcp` - `packages/mcp-server` The above three packages use `MIT` license, see their respective directory `LICENSE` files for details. Except for the above three packages, the rest of the Web, server-side, deployment, and runtime code use `AGPL-3.0-only`, see the repository root directory [LICENSE](LICENSE). Note: - `AGPL-3.0-only` does not prohibit commercial use, but requires modified network services to provide corresponding source code obligations when providing external services - `MIT` packages allow commercial use, redistribution, and secondary development, but must retain copyright and license statements --- <div align="center"> **Tai Bu** - Use AI to interpret destiny, use technology to inherit culture Made with ❤️ by [hhszzzz](https://github.com/hhszzzz) </div>