Qimen Dunjia & BaZi Charts

io.github.wyl743405571-cpuPublished by GitHub account wyl743405571-cpuv1.0.1Updated Nov 1, 2026

Free Qimen Dunjia and BaZi charts via MCP - deterministic engine, nine palaces and four pillars.

VerifiedStreamable HTTPWeb executableLocation & Lifestyle

Overview

AI-generated overview

Remote MCP server that casts Qimen Dunjia nine-palace charts and BaZi four-pillar charts from a given date and time, free of charge.

What you can do
  • Cast a Qimen Dunjia chart for a date and time, returning the nine-palace layout, deities, stars, doors, void palaces, detected formations and a rule-based reading, in Chinese or English.
  • Cast a BaZi natal chart with pillars, hidden stems, Ten Gods, day-master strength evidence, pattern with grade, favorable and unfavorable elements, and the current luck cycle.
  • Both tools use a deterministic calculation engine, so the same input gives the same output each run.
When to use it
Useful when someone wants Chinese metaphysics charts — Qimen Dunjia timing charts or BaZi natal charts — generated and explained inside a chat, without installing a local package. Both tools are listed as free, so it suits occasional or exploratory use.
Requirements
A remote streamable HTTP endpoint; no package installation, account, API key or environment variable is declared. Network access to the provider's host is required.
Before you install
The charts and readings are interpretive metaphysical content, not verified predictions; the README itself notes that interpretation and judgment rules are outside the engine and that case-library accuracy is partial. Requests send the date, time and language to a third-party server.

Installation

In SourceWeft

  1. Open Qimen Dunjia & BaZi Charts in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.wyl743405571-cpu%2Fqimen-dunjia-engine/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "qimen-dunjia-bazi-charts": {
      "type": "http",
      "url": "https://qimenseek.aicreditsapi.com/mcp"
    }
  }
}

README

qimen-dunjia-engine

Qimen Dunjia (奇门遁甲) chart calculation engine for Node.js — deterministic, no AI/LLM dependency, pure calculation.

时家转盘法 · 置闰符头定元 · 值使独立转门

实测数据(每一条都可复现,脚本在 verify/):44,064 次全量遍历崩溃 0、不变式违反 0;41 种格局零命中盘 0%、无恒真规则、无死规则;拆补 vs 置闰分歧率 41.6%;两批书载案例审计(142 例与 79 例,各自独立口径,不可混算)。

Why this engine

Most open-source Qimen libraries cut corners. This one implements the classical mainstream ruleset faithfully:

RuleCommon shortcut in other librariesThis engine
Zhirun (置闰) ju determination~5-day bucket approximationFutou-based: solar-term attribution decided by the futou day (上元符头 = 甲子/甲午/己卯/己酉)
Zhi-Shi door (值使门)Falls into the same palace as Zhi-Fu star (skipped rotation)Rotates independently from the hour-stem position in the xun
Rotating plate pathsLinear palace order 1-9Plate palace order [1,8,3,4,9,2,7,6]
ValidationSpot checks at best44,064-chart sweep, 0 crashes, 5 invariants enforced — verify/

Features

  • Hour-based rotating-plate method (时家转盘), Chabu (拆补), Zhirun (置闰) and Shen Jie Qi (超神接气) determination
  • Full plate: earth plate (地盘), heaven plate (天盘), 9 stars (九星), 8 doors (八门), 8 gods (八神), hidden stems (遁干)
  • Formation detection (格局): 41 formations detected in real computation — Fu-Yin (伏吟), Fan-Yin (反吟), 门迫, 击刑, 入墓, 青龙返首, 飞鸟跌穴, 玉女守门, 三奇得使, 十干克应 combinations, and more
  • Horse palace (马星), void branches (旬空), year/month stems lodging
  • Four-pillar (干支) calculation for year/month/day/hour via lunar-javascript
  • Zero network, zero AI — same numbers every run

Install

bash
# Install straight from GitHub (npm supports this natively)
npm install github:wyl743405571-cpu/qimen-dunjia-engine

# Or clone + install
git clone https://github.com/wyl743405571-cpu/qimen-dunjia-engine.git
cd qimen-dunjia-engine && npm install

# npm registry package: coming soon

Usage

js
const qimen = require('qimen-dunjia-engine');

// year, month, day, hour, minute, method: 'zhirun' | 'chaibu' | 'shenjieqi'
const chart = qimen.paipan(2026, 6, 7, 11, 0, 'zhirun');

console.log(chart.juNum);        // 6  (Yang Dun 6)
console.log(chart.isYang);       // true
console.log(chart.zhiFuXing);    // 天蓬 — Zhi-Fu star
console.log(chart.zhiFuGong);    // 4
console.log(chart.zhiShiMen);    // 休门 — Zhi-Shi door (independently rotated)
console.log(chart.zhiShiGong);   // 3
console.log(chart.dp);           // earth plate stems, keyed by palace 1-9
console.log(chart.tp);           // heaven plate stems
console.log(chart.xing);         // 9 stars by palace
console.log(chart.men);          // 8 doors by palace
console.log(chart.shen);         // 8 gods by palace
console.log(chart.geju);         // detected formations [{name, level, gong, detail}]
console.log(chart.maGong);       // horse palace
console.log(chart.kong);         // void branches, e.g. ['寅','卯']
console.log(chart.ygz);          // four pillars: year/month/day/hour ganzhi

See examples/basic.js for a runnable demo that prints a full nine-palace grid.

Output reference

FieldMeaning
juNum / isYangJu number (1–9) and Yin/Yang dun
methodzhirun / chaibu / shenjieqi
xun / kong / kongGongsHour xun, void branches, void palaces
zhiFuXing / zhiFuGongZhi-Fu star and its palace
zhiShiMen / zhiShiGongZhi-Shi door and its palace
dp / tpEarth / heaven plate stems by palace
xing / men / shenStars / doors / gods by palace
dunGanHidden stems (遁干)
gejuDetected formations with auspicious/inauspicious level
maGongHorse palace (驿马)
ygz / mgz / dgz / hgzYear / month / day / hour pillars

Scope

This package computes charts only. Interpretation, judgment rules (用神/断法), and case libraries are not included — those are product-layer assets of QiMenSeek.

The engine is流派-aware in one dimension: it implements the mainstream hour-based rotating-plate tradition (时家转盘). It does not compute flying-plate (飞盘) charts.

Test & Verification

bash
npm test    # 3 known-good snapshot charts + plate-structure invariants

That only covers three sample charts. For real numbers, run the measurement suite — every figure quoted in this README comes from these scripts, and you will get the same output on your own machine:

bash
node verify/sweep_coverage_v2.js 2000 2050   # 44,064 charts: 0 crashes, 0 invariant violations
node verify/measure_divergence.js 30# 12,960 moments: 41.6% of charts differ between Chaibu/Zhirun
node verify/measure_geju.js 10                # 41 formations, 0% zero-hit charts, no dead rules
node verify/audit_book_cases.js               # 142-case classical library audit
node verify/audit_book_cases_v2.js            # 79-case 1990s casebook audit (incl. Shen Jie Qi mode)

See verify/README.md for what each script proves, what it does not prove, and the measurement traps we hit while writing them.

Known limitation we do not hide

The 142-case classical library (verify/book_case_library_tagged.json, 95.8% with page citations) reproduces the book-stated ju number 64.9% of the time under Chaibu (63/97 testable) vs 42.6% under Zhirun (40/94). Only 51 of 142 cases carry an expected verdict, and 45 of those are OCR-extracted and still flagged needsReview. So: use the library for regression exploration, not as an accuracy claim.

The second, independent library (verify/book499_case_library.json, 79 testable cases from a 1990s casebook) reproduces the book-stated ju 82.3% under Chaibu (65/79) and 91.1% under the Shen Jie Qi mode (72/79). Note what that mode is: it is fitted from this casebook's own data — it explains this book, it does not claim to be "more classical". The default remains Chaibu. Five boundary cases stay unexplained, listed by the script itself. The two libraries never mix: different books, different denominators.

Live tools

End-user guides & articles

For people facing real decisions — not just developers — these plain-language guides explain the system (no mysticism, full reasoning, every claim sourced to your chart's symbols) and link back to the free tools:

Index: articles/README.md

License

MIT

Source: README.md at commit 6f934a8

Tools

2

qimen_pan

奇门遁甲排盘 · Qimen Dunjia Chart

Cast a Qimen Dunjia (奇门遁甲) chart for a given date/time. Deterministic engine (Zhi Run method, verified against classical case ledger). Returns the 9-palace chart, deities/stars/gates, void palaces, detected formations (geju) and a rule-based reading. FREE — no quota consumed. 中文/English via lang.

Parametersdaterequiredlangtimerequiredscene

bazi_chart

八字排盘 · BaZi (Four Pillars) Chart

Cast a BaZi (Four Pillars) natal chart. Deterministic engine (solar-term month pillar, Five-Rats hour rule, true-solar-time ready). Returns pillars with hidden stems and Ten Gods, day master strength evidence chain, geju pattern with grade, favorable/unfavorable elements, current luck cycle. FREE — no quota consumed. 中文/English via lang.

ParameterslanggenderbirthDaterequiredbirthTimerequired

Version history

1
  1. v1.0.1LatestNov 1, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts