Back to directory

qimen

In a curated listMaintenance: Active

oceanjustinlin/qimen

Adds mcp__xuanxue__bazi/ziwei/qimen/astro/calendar tools plus four divination reading-guide skills to a DSH profile.

View on GitHubHomepage
$ npm install

28

stars

12

forks

JavaScript

Language

MIT

License

2026-02-26

Created

2026-11-19

Last push

MIT JavaScript plugin that puts the qimen divination engines into DeepSeek Harness as 5 MCP tools plus 4 reading-guide skills — time-based qimen event charts, four-pillar bazi, ziwei charts and Western natal charts, each computed by a local Node script before the model writes a single word.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-16

License

MIT

01What can it help you accomplish?

  • Ask one concrete question in a DSH session — take the offer or not, will the interview land, can the project move, will the lost item come back — and get a time-based qimen chart instead of clicking through a web form

    The nine-palace chart the CLI built (甲子隐遁, 符头 positioning, nine stars, eight gates, eight gods) with a situation score, risk signals, break-through nodes, favourable directions and times, and action advice

    People who already use DSH as a decision partner and want the chart and its score to come from a deterministic script rather than the model's own reckoning

  • Read a four-pillar (八字) chart for structure and long-range trend, entering the birth data through the solar calendar, the lunar calendar or a reverse lookup by the four pillars

    The four pillars with 十神, 藏干, 十二长生, 纳音, 旬空亡, 神煞 and special formations, plus a local rule engine's verdict on day-master strength, favourable / unfavourable elements and formation — the same engine the website runs

    Users who need the in-session reading to match what the website concluded, and who care that the result is reproducible across models

  • Open a ziwei (紫微斗数) chart for the same birth profile: twelve palaces, star brightness, the four transformations and the decade / year / month cycles

    The twelve palaces with major, auxiliary and minor stars and their brightness, 命主 / 身主, the five-element bureau, the body palace and the birth-year four transformations

    DSH users who want a second chart tradition beside bazi, or a cross-check between the two

  • Cast a Western natal chart from the same birth data — planet in sign and house, retrograde, ascendant, midheaven, houses, the five main aspects

    A natal chart with planets in signs and houses including retrograde, ascendant and midheaven, houses, the five major aspects, element and modality distribution, day or night chart and chart ruler

    Users comparing the Chinese systems against a Western chart, or who only want the Western one

02How to install into DeepSeek Harness

Prerequisites

  • Node.js 22.12 or newer — the engine reuses `src/utils` through `require(esm)`
  • A repo checkout: neither `xuanxue-mcp` nor `xuanxue-dsh` is published to npm yet, so the MCP server is started from the checkout
  • DSH with its built-in MCP client, which the shell uses to reach the 5 tools

Installation steps

  1. 01

    In the repo root: `npm install`

    $ npm install

  2. 02

    Local dev server: `npm run dev`; build: `npm run build`

    $ npm run dev

  3. 03

    Backend locally: `cd worker`, then `npx wrangler dev` — it serves http://localhost:8787 and the frontend proxies `/api/*` there

    $ npx wrangler dev

  4. 04

    DSH: `dsh plugin --profile web add xuanxue-dsh` once the package is published — the README notes it is not on npm yet

    $ dsh plugin --profile web add xuanxue-dsh

  5. 05

    Other MCP clients: `claude mcp add xuanxue -- node <repo absolute path>/packages/xuanxue-mcp/src/server.mjs`

Verify the integration

  • `npm test` — the README describes two stages: all unit and e2e tests first, then the MCP packaging smoke test serially (that one installs dependencies over the network once)
  • `scripts/bazi_cli.test.cjs` is the parity smoke test that locks the wrapper to the engine field by field; it is part of `npm test`

03DSH integration and capability boundaries

DSH integrationNative runtime

DSH plugin shell `xuanxue-dsh` (`packages/xuanxue-dsh`) — wraps the `xuanxue-mcp` stdio server, reaches its 5 tools (`bazi` / `ziwei` / `qimen` / `astro` / `calendar`) through DSH's built-in MCP client, and registers the 4 reading guides as DSH skills because DSH does not support MCP prompts; installed with `dsh plugin --profile web add xuanxue-dsh` (not published to npm yet)

04Who is it for? When not to use it?

Good for

  • People who already use DSH as a decision partner and want the chart and its score to come from a deterministic script rather than the model's own reckoning
  • Users who need the in-session reading to match what the website concluded, and who care that the result is reproducible across models
  • DSH users who want a second chart tradition beside bazi, or a cross-check between the two
  • Users comparing the Chinese systems against a Western chart, or who only want the Western one

Not for

  • Neither package is on npm yet: the README says `dsh plugin --profile web add xuanxue-dsh` installs after publication, and until then the stdio server has to be started from a repo checkout.
  • Node ≥ 22.12 is required; the calculation core itself is fully local — no network access and no API key.

05Compatibility, maintenance and safety notes

  • Neither package is on npm yet: the README says `dsh plugin --profile web add xuanxue-dsh` installs after publication, and until then the stdio server has to be started from a repo checkout.
  • Node ≥ 22.12 is required; the calculation core itself is fully local — no network access and no API key.
  • A reading needs a complete birth input: the hour is mandatory, bazi and ziwei also require gender, and the qimen skill casts at the moment of asking with no multi-hour election in v1.
  • The README documents the project shape and local development only — no public deployment guide, no secret configuration, no self-hosting steps, because the hosted service is the author's personal site.
2026-02-262026-11-13Not specified by the author

MIT · no release yet · actively pushed (last push 2026-11-13); DSH shell not yet on npm

06Frequently asked questions

How do I install it into DeepSeek Harness?

The shell is `packages/xuanxue-dsh` in the repo and installs with `dsh plugin --profile web add xuanxue-dsh`. The README says that command applies after publication and that the packages are still unpublished, so for now start the stdio server from the checkout — the README's own example for MCP clients is `claude mcp add xuanxue -- node <repo absolute path>/packages/xuanxue-mcp/src/server.mjs`.

Which tools and skills appear in a DSH session?

5 MCP tools — `bazi`, `ziwei`, `qimen`, `astro` and `calendar` — plus the 4 reading guides kept in `packages/xuanxue-mcp/prompts/`. DSH does not support MCP prompts, so the shell registers those guides as DSH skills instead, and SKILL.md shares one body of text with the MCP prompt.

Does running it from DSH need an API key or a network connection?

No. The README describes the calculation core as purely local — no network, no API key — because the connected agent is the model that does the reading. What it does need is Node ≥ 22.12, since the engine reuses `src/utils` through `require(esm)`.

What input does a reading need?

Birth data goes through the shared `lib/birthInput.cjs` contract: the hour is mandatory, bazi and ziwei also need gender, and a birthplace converts to true solar time. Western astro is the exception — no gender, no true solar time, the birthplace time zone is converted to UTC, and a missing birth time returns `TIME_REQUIRED`. The qimen skill casts at the moment of asking and does no multi-hour election in v1.

Can I run the website itself?

Only for local development: `npm install`, `npm run dev`, `npm test`, with the backend started separately through `cd worker` and `npx wrangler dev` on http://localhost:8787. The README states this is the author's personal site and deliberately ships no public deployment guide, no secret configuration and no self-hosting steps.

08Data and sources

  • Author-claimedgithub.comfb89987675ff…

    **DeepSeek Harness(dsh)插件**:[`packages/xuanxue-dsh`](./packages/xuanxue-dsh/) 是包装 xuanxue-mcp 的薄壳组合包,用 dsh 自带的 MCP 客户端接入…

  • Author-claimedgithub.comfb89987675ff…

    发布后用 `dsh plugin --profile web add xuanxue-dsh` 安装;同样尚未发布到 npm。

  • Author-claimedgithub.comfb89987675ff…

    │ └── xuanxue-dsh/ # DeepSeek Harness 插件(薄壳:MCP 接入配置 + 解读守则 skill)

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-16. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.