Content
<div align="center">
<img src="public/favicon.svg" alt="MingAI" width="80" height="80">
# Tool List
**Integrating Traditional Culture with AI**
[](https://nextjs.org/)
[](https://www.typescriptlang.org/)
[](https://tailwindcss.com/)
[](https://supabase.com/)
[](https://vercel.com/)
Language: | [English](README.en.md)
[Live Demo](https://www.mingai.fun) · [Report Issues](https://github.com/hhszzzz/MingAI/issues)
</div>
---
## Product Highlights
- **Multiple Divination Systems** - Eight Characters, Six Lines, Ziwei Doushu, Qimen Dunjia, Daliuren, Meihua Yishu, Tarot, MBTI, Face Reading, Palm Reading, Synastry, Zhou Gong's Dream Interpretation
- **AI Intelligent Analysis** - Supports exporting divination system text for AI analysis, multiple model support, in-depth reasoning, and visual recognition
- **MCP Server** - Supports Model Context Protocol (MCP), can be called directly in MCP-supported clients
- **History Records, Knowledge Base, and @Mention** - Supports storing records of all divination systems, can include divination systems in personal knowledge base, and explicitly cite divination system data sources
- **AI Personalization** - Expression style/user profile/custom instructions + context, prompt word budget visualization
- **Multi-Platform 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, lunar calendar, immediate charting, four pillars charting<br/>· Five elements, heavenly stems, earthly branches, ten gods, hidden stems, star luck, sound, and divine killers (51 types), twelve long lives, punishment and harm<br/>· Heavenly stem combination, earthly branch semi-combination, earthly branch three meetings<br/>· Grand fortune, flow year, flow month, flow day<br/>· Traditional analysis, blind school analysis |
| **Ziwei Doushu** | · 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/ flow year/ flow month/ flow day/ flow time limit analysis<br/>· Flying star analysis (flying transformation/ self-transformation/ four transformations and palace) |
| **Qimen Dunjia** | · Nine palaces, heaven and earth plates, eight doors, nine stars, eight gods<br/>· Value symbol value makes, hidden type, bureau number<br/>· Pattern judgment (good/ bad), empty, nomadic horse, into tomb, prosperity and decline<br/>· Rotating plate arrangement, disassembly and supplement/ Mao Shan bureau method<br/>· Explicit time zone support |
| **Daliuren** | · Heaven and earth plates, four lessons, three transmissions<br/>· Heavenly general (twelve gods), 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 year |
| **Six Lines** | · Coin hexagram, fast hexagram, selected hexagram, time hexagram, digital hexagram<br/>· Yao change clear movement, dark movement<br/>· Hexagram words, Yao words, image words<br/>· Use god, original god, volt god, hate god<br/>· Empty and dead, world response, prosperity and decline state, punishment and harm<br/>· Mutual hexagram, wrong hexagram, comprehensive hexagram<br/>· Response period prediction |
| **Meihua Yishu** | · Year, month, date and time hexagram, object number/ sound number, character occupation, ruler size and dimension, orientation class elephant<br/>· Two/ three number report extension method<br/>· Original hexagram, inter hexagram, change hexagram, wrong hexagram, comprehensive hexagram, moving Yao<br/>· Body hexagram/ use hexagram, body and use life and death, month order prosperity and decline, gram should level<br/>· Response period clue, qualitative good and bad judgment |
| **Tarot** | · 9 card arrays: single card, three card array, love card array, Celtic cross, horseshoe, choice, mind and spirit, situation, yes/ no<br/>· Reversal judgment, 78 complete card surface interpretation, exquisite 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 and Palm Reading** | · Heavenly courtyard, nose phase, eye phase, mouth phase<br/>· Life line, wisdom line, career line, emotional line |
| **Fortune Center** | · Daily, monthly fortune analysis based on birth chart<br/>· Daily almanac (including orientation system, 12 hours good and bad, twenty-eight stars)<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/>· Supports AI dialogue mentioning all divination systems<br/>· Annual divination report |
---
## MCP
MingAI provides MCP, which can directly call divination tools in MCP-supported clients.
### Quick Configuration
Add the following content to the configuration to use:
```json
{
"mcpServers": {
"mingai": {
"command": "npx",
"args": ["-y", "@mingai/mcp"]
}
}
}
```
### Supported Tools
| Tool | Function | Question Examples |
| --- | --- | --- |
| `bazi` | Eight Characters (supports solar/lunar calendar, 51 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 Gui Si, please help me analyze" |
| `bazi_dayun` | Eight Characters grand fortune calculation (ten-year fortune cycle, flow year details, Tai Sui marking, small fortune) | AI will automatically analyze your eight characters and call calculation |
| `ziwei` | Ziwei Doushu charting (including life master star/ body master star, small limit, doctor 12 stars, three sides and four positives) | "I was born on the fourth day of the fourth lunar month in 1990, please arrange Ziwei chart" |
| `ziwei_horoscope` | Ziwei fortune limit (limit/ small limit/ flow year/ flow month/ flow day/ flow time, flow year star) | "Help me see the Ziwei fortune limit in 2026" |
| `ziwei_flying_star` | Ziwei flying star analysis (flying transformation/ self-transformation/ four transformations and palace/ three sides and four positives) | "Analyze the flying star of my life palace" |
| `liuyao` | Six Lines divination (supports hexagram/ autonomous hexagram/ time hexagram/ digital hexagram, including inter hexagram/ wrong hexagram/ comprehensive hexagram) | "I want to divinate my career fortune this year, please help me hexagram analysis" |
| `meihua` | Meihua Yishu (supports year, month, date and time, object number/ sound number, character occupation, ruler size and dimension, orientation class elephant, two/ three number report) | "Now start a hexagram, use Meihua Yishu to see if this cooperation can be successful" |
| `tarot` | Tarot drawing (9 card arrays, 78 complete card surface, independent reversal keyword, constellation/ element correspondence) | "Please draw a Tarot card for me, about recent love fortune" |
| `almanac` | Almanac query (including orientation system, 12 hours good and bad, twenty-eight stars) | "How is today's almanac? Is it suitable for marriage?" |
| `qimen` | Qimen Dunjia charting (nine palaces, eight doors, nine stars, eight gods, value symbol value makes, explicit time zone) | "Use Qimen to see if it's smooth to discuss cooperation today" |
| `daliuren` | Daliuren charting (four lessons and three transmissions, heaven and earth plates, gods, explicit time zone) | "Use Daliuren to see the result of this matter" |
### SDK
If you want to directly call the calculation engine in your Node.js project (without MCP protocol), you can use the core library:
```bash
npm install @mingai/core
```
See [@mingai/core npm page](https://www.npmjs.com/package/@mingai/core) for details.
---
## Quick Start
### Docker Deployment
Supports three methods:
```bash
# Prepare environment variables (first)
cp .env.example .env
# 1) One-click deployment: start Web + MCP simultaneously
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/MingAI.git
cd MingAI
# 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
Feel free to submit issues and pull requests!
---
## License
This project is for learning and communication purposes only.
---
<div align="center">
**MingAI** - Interpreting Destiny with AI, and Cultural Heritage with Technology
Made with ❤️ by [hhszzzz](https://github.com/hhszzzz)
</div>
