Mingpan MCP
The Mingpan MCP server calculates Chinese bazi, ziwei, liuyao and qimen charts from a date and leaves interpretation to the model.
- 131 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The remote server receives the birth date and time, while a local stdio run keeps them on the machine.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mingpanDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The remote server receives the birth date and time, while a local stdio run keeps them on the machine.
This is third-party code. Review the repository files before installing.
What it does
Mingpan calculates charts of traditional Chinese metaphysics. The calculation is deterministic: the server returns structured text, and the model does the interpretation from the finished chart. The set covers bazi with major cycles, years, months and days, ziwei doushu with twelve palaces and four transformations, liuyao, meihua and the daliuren and qimen dunjia systems. Calendar tools stand apart: `jieqi_query` gives the exact time of the twenty-four solar terms and `calendar_convert` converts between solar and lunar calendars. The server runs at the remote address `https://mingpan.bzwai.com/mcp` with no installation, or locally over stdio. Output is in Chinese, and world time zones are converted to Beijing time.
Who it is for. Developers of Chinese metaphysics apps and bots who need an exact chart calculation instead of a model's guesses.
Good fit when
- A bot takes a birth date and must return a bazi chart without errors in the pillars.
- A calendar task needs the exact moment a solar term begins, for example the start of spring.
- A birth time abroad is converted to Beijing time and a ziwei chart is calculated.
- An app checks its own formulas against an independent qimen or daliuren calculation.
Not a fit when
- You expect a ready interpretation of fate: the server returns only the calculation and the model adds meaning.
- You need a Western astrology chart: the server calculates only Chinese systems.
- You need calculations outside the years 1900–2100.
Example request
Build a bazi chart for a man born on 12 April 1992 at 7:30 and list the ten-year cycles.MCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
The calculation covers the years 1900–2100. Output is in Chinese, and only the documentation exists in other languages. The remote address suits clients with Remote MCP, and the rest run the server locally over stdio. Version 0.1.8 fixed a line-order error in meihua: results of older versions for the changed and nuclear hexagrams must be recomputed. The server does not interpret a chart, which stays with the model. The remote address needs network access, and a local run needs Node.js.
How to disable. Remove the mingpan entry from the MCP client configuration, or the remote address from the server list.
FAQ
How do I connect Mingpan to Claude Code?
For a local run, execute `claude mcp add mingpan -- npx -y mingpan`. Clients with Remote MCP can simply add the address `https://mingpan.bzwai.com/mcp`.
Which systems does the server calculate?
Bazi, ziwei doushu, liuyao, meihua, daliuren and qimen dunjia. Calendar conversion and solar-term times are available separately.
What comes back in the reply?
Structured text with the chart calculation in Chinese. It carries no conclusions about fate: the model draws them from the chart.
Does birth data go to the server?
With the remote address, yes: the server receives the date and time. The authors state it stores nothing. A stdio run keeps the data on your machine.
What does jieqi_query do?
It returns the exact start moment of any of the twenty-four solar terms, to the second, in Beijing time.
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
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
A Chinese destiny-chart skill: scripts compute Bazi and Zi Wei Dou Shu charts and the agent reads them with a fixed method.
Skill for Zi Wei Dou Shu charts: a script computes the birth chart, rules classify the pattern and an HTML report with two themes is built
An MCP server with 34 tools: prayer times for any point on Earth, the Hijri calendar, adhkar, zakat and inheritance calculation
README in short
The authors explain the value of calculation this way: solar terms are astronomically exact, while models often guess leap months of the lunar calendar wrongly. Documentation exists in Chinese, English and Japanese.