TaiBu: fortune charts and tarot over MCP
TaiBu
An MCP server with 15 calculation tools: BaZi, Zi Wei Dou Shu, Liu Yao, Qi Men Dun Jia, tarot, Western astrology and the Chinese almanac
- 762 ★ on the repository
- Last commit
Extended access
Why this level
- The public address receives birth date, hour and place over the network, and these count as personal data
- Answers contain divinatory readings: an agent may present them as forecasts, and a person may act on them
Install
- Works in
Manual install
claude mcp add taibu -- npx -y taibu-mcpLocal stdio mode, the taibu-mcp npm package, Node.js required. The command repeats the author's JSON configuration for Claude Code.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The public address receives birth date, hour and place over the network, and these count as personal data
- Answers contain divinatory readings: an agent may present them as forecasts, and a person may act on them
This is third-party code. Review the repository files before installing.
What it does
TaiBu plugs into an agent as an MCP server and computes fortune charts in code, so the model does not guess stems, branches and stars from memory. The `bazi` tool builds the four pillars from a birth date with ten deities, hidden stems and fifty-one auxiliary stars, `bazi_dayun` adds the ten-year luck cycles and yearly influences, and `bazi_pillars_resolve` takes finished pillars and finds candidate birth moments between 1900 and 2100. Zi Wei Dou Shu gets three tools: the palace chart, the period flow (`ziwei_horoscope`) and flying-star analysis (`ziwei_flying_star`). The other systems get one each: `liuyao`, `meihua`, `qimen`, `daliuren`, `xiaoliuren` and `taiyi`, plus `tarot` with nine spreads on 78 cards, `astrology` with a natal chart and transits, and `almanac` with the Chinese almanac for a day. Every answer comes in two forms: canonical text for reading and structured JSON where the tool has an output schema. The repository also ships the `taibu-divination` skill, which runs the same calculations locally through a bundled Node.js engine and tells the agent to read the result from tool output.
Who it is for. For people who ask Claude Code, Cursor or Claude Desktop for a reading, a destiny chart or a date pick and want a calculation from code that can be rechecked.
Good fit when
- You need a BaZi chart from a birth date and hour with luck cycles and yearly influences, and the model keeps mixing up the Chinese calendar
- You already have the four pillars and want candidate birth dates for them, which is what `bazi_pillars_resolve` does
- You are reading a Zi Wei Dou Shu chart with periods and flying stars, and every position has to be computed by a program
- You want a tarot spread on one of nine layouts or a natal chart with transits for the agent to interpret afterwards
- You want a quick look at what the Chinese almanac says about one date, for example a moving day, through `almanac`
Not a fit when
- You need proof that a spread predicts events: the server computes positions by the rules of a school and tests nothing in practice
- Birth data must not leave your machine and you are not ready to run the server or the skill locally: the public address takes your data over the network
- You embed the calculations in a project that is not on Node.js: the core ships as the JavaScript package `taibu-core`, and the MCP server needs a separate process
- You expect an interpretation in Russian: calculations and their hints come out in Chinese, and translation is left to the model
Example request
Build a BaZi chart: male, born 20 May 1990 at 8 a.m. Call bazi and bazi_dayun and retell the result in plain language without calculating anything yourselfMCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
The server tools are described in Chinese and work with Chinese terms, so palace, star and hexagram names arrive in characters and the model does the translation. The public server lives at the author's address and needs no key. For fully local work use the `taibu-mcp` package in stdio mode or the skill that runs the bundled engine on your own machine.
Chart methods differ between schools: the server computes by the rules the author fixed and does not promise another practitioner would reach the same conclusions. The four-pillar search covers 1900–2100, with up to 1200 years checked per call.
The same repository holds a large web service with accounts, a database and phone apps. Only the MCP package is needed from it, and the rest is licensed separately: the `core`, `mcp` and `mcp-server` packages are MIT, the other code is AGPL-3.0-only.
How to disable. Remove the server from the MCP settings: `claude mcp remove taibu` for Claude Code, or delete the taibu entry from the configuration in Cursor and Claude Desktop. The skill goes away with the folder you put it in.
FAQ
How do I connect TaiBu to Claude Code?
Locally, with no network calls: `claude mcp add taibu -- npx -y taibu-mcp`, Node.js required. If you would rather install nothing, add the public address `https://mcp.mingai.fun/mcp` over HTTP, but then your birth data goes to the author's server.
Do I need a key or an account?
No. The public MCP server runs without OAuth, API keys or session headers. Accounts only matter for the author's web app and have nothing to do with MCP.
Which systems does TaiBu compute?
BaZi, Zi Wei Dou Shu, Liu Yao, Mei Hua, Qi Men Dun Jia, Da Liu Ren, Xiao Liu Ren, Tai Yi, tarot, Western astrology and the Chinese almanac. That is 15 tools, and `tools/list` prints them.
How is the skill different from the MCP server?
The `taibu-divination` skill starts no server: the agent runs `node scripts/taibu.mjs` from the skill folder and the same engine computes in-process. It fits when there is no MCP client but Node.js 18 or newer is available.
Can the results be trusted as forecasts?
There is no basis for that. The server returns a calculation under the rules of the chosen school, and the model supplies the interpretation. It is not a source for decisions about health, money or relationships.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server that calculates a Bazi chart from a birth date and returns the Chinese almanac, with no guessing of characters
OpenFate Bazi MCP: Bazi chart calculation
OpenFate Bazi MCP
An MCP server that calculates Bazi charts and true solar time deterministically so the model skips calendar guesswork
The Mingpan MCP server calculates Chinese bazi, ziwei, liuyao and qimen charts from a date and leaves interpretation to the model.
A Chinese destiny-chart skill: scripts compute Bazi and Zi Wei Dou Shu charts and the agent reads them with a fixed method.
An MCP server and CLI that compute natal charts, Bazi, Qimen and tarot offline, so the agent works from real chart data
A skill that computes Bazi and Zi Wei Dou Shu charts by algorithm, then the model reads the result and builds an HTML poster.
README in short
The MCP section covers the public streamable-http server and the local stdio mode. A table pairs each of the fifteen tools with a sample question. For embedding in your own code the author offers a separate `taibu-core` npm library.