mcpField
T
taibu-divination

taibu-divination

github.com/hhszzzzその他70065 回インストール2 週間前に更新
リポジトリ

taibu-divination について

太卜は、中国の占術、タロット、西洋占星術、暦の照会に対応する15種類のツールを備えたスキルです。計算エンジンを同梱し、Node.js 上でローカル実行でき、解釈はツール出力を根拠にします。

主な機能

  1. 0115種類の占術・命盤ツール
  2. 02ローカル計算エンジンを同梱
  3. 03テキストまたは構造化 JSON 出力
  4. 04パラメーター説明と使用例
  5. 05体系別の解釈ガイド

活用シーン

  1. 01八字や紫微斗数の命盤作成
  2. 02六爻や奇門遁甲の占い
  3. 03スプレッドに沿ったタロット抽出
  4. 04指定日の暦情報の照会

MCP 対応

MCP 対応クライアントは、npm パッケージ taibu-mcp の stdio 接続または公開 MCP エンドポイントから同じツール群を利用できます。

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/taibu-divinationを入力して読み込まれたか確認します。

同梱ファイル

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

詳細

プロジェクトの 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,工具集相同。

コメント