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
- 01
In the repo root: `npm install`
$ npm install
- 02
Local dev server: `npm run dev`; build: `npm run build`
$ npm run dev
- 03
Backend locally: `cd worker`, then `npx wrangler dev` — it serves http://localhost:8787 and the frontend proxies `/api/*` there
$ npx wrangler dev
- 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
- 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 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)
Five stdio tools behind one CLI contract
The same JSON envelope on every call — `chart` / `judgments` / `evidence` / `confidence` / `limitations` / `warnings` / `conventions` — plus a calendar CLI for solar / lunar conversion, true solar time and the solar terms
Four reading guides delivered as DSH skills
Time-based qimen (奇门) chart engine
Four-pillar (八字) chart engine
Ziwei (紫微斗数) chart engine
Western natal chart engine
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.
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.
07Related DSH workflows
dsh-baton
by jialaoliu
Pass the baton from Claude Code or Codex to a local DeepSeek Harness. An MCP server that hands off tasks and brings the result back.
dsh-crew
by zseven-w
DeepSeek Harness (DSH) plugin: dispatch work to DSH agents from Claude Code / Codex — native subagent progress, in-host worker sessions with per-tier presets, and a multimodal bridge that lends the text-only harness vision and image generation.
dsh-mcp-apps-host
by oriliz
MCP Apps Host plugin for DeepSeek Harness: renders interactive HTML cards from MCP _meta.ui in sandboxed iframes, bridges postMessage to MCP tools/call and resources/read
eac-design-world
by ebony-vinyl
Creates local video and design projects with a timeline, templates, media rendering, preview, and export.
08Data and sources
**DeepSeek Harness(dsh)插件**:[`packages/xuanxue-dsh`](./packages/xuanxue-dsh/) 是包装 xuanxue-mcp 的薄壳组合包,用 dsh 自带的 MCP 客户端接入…
发布后用 `dsh plugin --profile web add xuanxue-dsh` 安装;同样尚未发布到 npm。
│ └── 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.
