Content
<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>
MCP Config
Below is the configuration for this MCP Server. You can copy it directly to Cursor or other MCP clients.
mcp.json
Connection Info
You Might Also Like
markitdown
Python tool for converting files and office documents to Markdown.
OpenAI Whisper
OpenAI Whisper MCP Server - 基于本地 Whisper CLI 的离线语音识别与翻译,无需 API Key,支持...
oh-my-opencode
Background agents · Curated agents like oracle, librarians, frontend...
claude-flow
Claude-Flow v2.7.0 is an enterprise AI orchestration platform.
chatbox
User-friendly Desktop Client App for AI Models/LLMs (GPT, Claude, Gemini, Ollama...)
continue
Continue is an open-source project for seamless server management.