mcpField
T
taibu-divination

taibu-divination

github.com/hhszzzzOther70065 installsUpdated 2w ago
Repository

About taibu-divination

Taibu is a divination skill with 15 tools for charting and consultation across Chinese systems, Tarot, Western astrology, and almanac lookup. Its calculation engine is bundled for local Node.js use, and outputs serve as the factual basis for interpretations.

Key features

  1. 0115 divination and charting tools
  2. 02Local bundled calculation engine
  3. 03Text or structured JSON output
  4. 04Parameter schemas and examples
  5. 05Interpretation guidance by system

Use cases

  1. 01Generating a Bazi or Ziwei chart
  2. 02Casting a Liuyao or Qimen reading
  3. 03Drawing Tarot cards for a spread
  4. 04Checking almanac details for a date

MCP support

MCP-compatible clients can use the same tool set through the taibu-mcp npm package over stdio or the public MCP endpoint.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hhszzzz/taibu --skill taibu-divination

After installing, type/taibu-divinationin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
evals.json
interpretation/
almanac.md
astrology.md
bazi.md
daliuren.md
liuyao.md
meihua.md
qimen.md
taiyi.md
tarot.md
xiaoliuren.md
ziwei.md
references/
almanac.md
astrology.md
bazi_dayun.md
bazi_pillars_resolve.md
bazi.md
daliuren.md
liuyao.md
meihua.md
qimen.md
taiyi.md
tarot.md
xiaoliuren.md
ziwei_flying_star.md
ziwei_horoscope.md
ziwei.md
scripts/
taibu.mjs

Details

From the project README

太卜占术工具

太卜提供 15 个占术与命理排盘工具,涵盖八字、紫微斗数、六爻、梅花易数、奇门遁甲、大六壬、小六壬、太乙、塔罗、西方占星与黄历。计算引擎已随 skill 打包(scripts/vendor/taibu-core.bundle.mjs),本地直接运行,无需安装依赖,只要求环境中有 Node.js 18 或更高版本。

盘面一律由工具计算。干支、卦象、星曜的推算规则繁多,凭记忆手算既容易出错也无法复现;解读时以工具输出为唯一事实来源,不确定的细节回到输出中核对,而不是凭常识补写。

用法

TB 指本 skill 的根目录(加载 skill 时会告知):

node "$TB/scripts/taibu.mjs" list           # 列出全部工具
node "$TB/scripts/taibu.mjs" schema bazi    # 查看参数说明与调用示例
echo '{"gender":"male","birthYear":1990,"birthMonth":5,"birthDay":20,"birthHour":8}' \
  | node "$TB/scripts/taibu.mjs" call bazi -
  • 参数为 JSON。含中文内容时走 stdin(call <tool> -),避免 shell 转义问题。
  • 默认输出规范文本,适合直接作为解读依据;加 --json 改为输出结构化数据(structuredContent)。
  • 出错时返回中文提示(缺哪个参数、允许哪些取值),按提示修正后重试。退出码:0 成功,1 参数或业务错误,2 用法错误。

选择工具

工具名名称用途参数文档解读指引
astrology西方占星命盘根据出生信息计算本命盘与流运盘,输出基础坐标、命盘锚点、本命主星与流运触发references/astrology.mdinterpretation/astrology.md
bazi八字命盘根据出生信息排四柱命盘,输出四柱干支、十神、藏干、地势、空亡与干支关系,可选输出纳音、神煞等扩展信息references/bazi.mdinterpretation/bazi.md
bazi_pillars_resolve四柱反推根据四柱搜索分钟级出生时间区间,默认1900-2100,单次最多1200年references/bazi_pillars_resolve.mdinterpretation/bazi.md
ziwei紫微斗数命盘根据出生信息计算紫微命盘,输出十二宫位、星曜分布、四化、大限等信息references/ziwei.mdinterpretation/ziwei.md
ziwei_horoscope紫微斗数运限根据出生信息与目标日期计算大限、小限、流年、流月、流日、流时等运限信息references/ziwei_horoscope.mdinterpretation/ziwei.md
ziwei_flying_star紫微斗数飞星按查询逐条分析命盘宫位的四化飞入、自化、四化落宫与三方四正references/ziwei_flying_star.mdinterpretation/ziwei.md
liuyao六爻排卦根据问题与起卦信息排出六爻盘面,输出卦象、爻位、用神体系、关系判断与时机提示references/liuyao.mdinterpretation/liuyao.md
meihua梅花易数起卦根据时间、字占、物数、报数等方式起卦,输出起卦信息、卦盘与体用推演references/meihua.mdinterpretation/meihua.md
tarot塔罗抽牌按牌阵抽取塔罗牌,输出各牌位的牌面、正逆位、核心基调、元素与星象references/tarot.mdinterpretation/tarot.md
taiyi太乙排盘支持九星观测,以及采用四库本金镜七十二局立成的现代历法适配年/月/日/时计references/taiyi.mdinterpretation/taiyi.md
almanac黄历查询查询指定日期的黄历、宜忌、冲煞、值星、方位与时辰吉凶等信息references/almanac.mdinterpretation/almanac.md
bazi_dayun八字大运根据出生信息计算起运时间与大运列表,可选输出起运前小运及各步大运的流年references/bazi_dayun.mdinterpretation/bazi.md
qimen奇门遁甲排盘根据指定时间排出奇门盘,输出九宫、九星、八门、八神、格局等信息references/qimen.mdinterpretation/qimen.md
daliuren大六壬排盘根据日期时间起课,输出天地盘、四课、三传、神将、课体与时空信息references/daliuren.mdinterpretation/daliuren.md
xiaoliuren小六壬占测根据农历月日时辰起课,输出起课信息、推演链与结果信息references/xiaoliuren.mdinterpretation/xiaoliuren.md

调用前先 schema <tool>,或读 references/<tool>.md(参数表与可复制的示例)。

解读方法

排盘只是第一步。产出解读前,读工具表最后一列对应的 interpretation/<体系>.md——每份指引给出该体系的专家角色、流派技法与分析框架,按其组织解读内容。通用要求:

  • 断语必须引用盘面证据(干支、星曜、爻位、格局名与工具输出逐字一致),不确定的回到输出核对。
  • 正文以该体系术师的口吻写给问事人:先结论、后论证。工具调用与核验过程不写入正文,至多在文末一句带过——把篇幅留给卦理与判断,而不是操作记录。
  • 关键事件给出时间范围、吉凶属性与影响程度;建议针对当前盘面,不写放之四海皆准的空话。
  • 分析深度跟随用户要求伸缩:速断类(小六壬、单牌塔罗)短平快,命盘全局类(八字、紫微)分层展开,用户要求逐大限、逐流年时按指引调用运限工具补数据。

约定

  • 历法:生辰类工具默认公历(calendarType: "solar");用户给的是农历生日时改传 "lunar",闰月再加 isLeapMonth: true。xiaoliuren 例外,直接接收农历月、日。
  • 时间:birthHour 传 0-23 的钟表小时,早晚子时由引擎处理,不要自行折算时辰。xiaoliuren 的 hour 可传时辰序号 1-12(子=1),也可传 0-23 小时。用户未提供的出生信息应当询问,而非代为假设。
  • 占当下:qimen、daliuren、liuyao 与 meihua 的时间起卦需要当前时间时,先取系统时间(如 date +"%Y-%m-%dT%H:%M:%S")再填入参数。
  • 日期核实:用户说「今天/现在」并同时报出农历日期时,先取系统时间、用 almanac 核对公农历对应——农历与公历的映射是查历数据,不能凭记忆换算。口述与核实不符时,指出差异并以核实结果起盘,必要时附口述日期的对照结果。出生生肖、未来日期干支也以 Core 对相应日期的计算为准,不能从公历年份或单日盘面补算。
  • 随机性:tarot 可传 seed 复现抽牌;liuyao 的 method: "auto" 每次结果随机,需要复现时改用 select(指定卦名)或 number(数字起卦)。
  • 六爻用神:yongShenTargets 必填,按占问主题选择,可多选:事业官职、官司、疾病忧患取 官鬼;财运、男问感情取 妻财;文书合同、长辈、房产车辆取 父母;子女晚辈、健康平安取 子孙;合作竞争、朋友取 兄弟。
  • detailLevel:默认输出已够解读;需要完整盘面时在参数中加 "detailLevel": "full"(部分工具另有 "more")。

其他接入方式

支持 MCP 的客户端可以不经本 skill,直接使用 npm 包 taibu-mcp(stdio)或公网端点 https://mcp.mingai.fun/mcp,工具集相同。

Comments

Markdown supported