OracleBone 卜骨
中 EN 日 PT 한 ES

MCP server · v8.2.0 · MIT

让 AI 用可审计的随机性起卦、排盘、抽塔罗

蓍草概率、八字历法、64 卦全文——全部脚本计算，零幻觉。一次安装，Claude、Cursor、Gemini 都能用。

uvx oraclebone-mcp 在线试玩 → ★ GitHub

PyPI 已发布 · CI 全绿 · Docker 支持

hexagram.cast() 输出示例

{"hexagram": "䷾ 既济",
 "method":    "yarrow-stalk",
 "seed":      null,
 "audit":     "reproducible"}

为什么做这个

模型不应该自己编出占卜结果。

本项目把抽取与解释分开：本地脚本用系统随机或传统概率生成牌面、卦象或四柱，AI 只基于这个具体结果进行解读。

方法论严谨性

随机过程和 AI 解读清楚分开。

已包含技能

四个实用模块。

周易

蓍草法起卦，输出本卦、变爻与之卦，附 64 卦全文。

oraclebone iching --method yarrow

八字

真太阳时排四柱、五行、纳音；生肖按年柱口径，另附农历口径对照。

oraclebone bazi --datetime 1990-05-20T14:30

塔罗

大阿卡纳，牌阵可选，支持逆位，Fisher-Yates 洗牌。

oraclebone tarot --spread three-card --reversals

小六壬

农历数字或公历时间双起卦法，缺参报错直接指出缺什么。

oraclebone xiaoliuren --method numbers --month 3 --day 12 --hour 7

30 秒接入

把 MCP server 接到你的 Agent。

Claude Code / Desktop

claude mcp add oraclebone -- uvx oraclebone-mcp

Cursor

Settings → MCP → 粘贴 JSON 配置

Gemini CLI

gemini mcp add oraclebone

Codex / 其他

stdio JSON-RPC · 标准 MCP 协议

或者直接用 CLI

pip install oraclebone
oraclebone iching --method yarrow
oraclebone bazi --datetime 1990-05-20T14:30:00
oraclebone tarot --deck major --spread three-card --reversals

一键安装

把一句话发给你的 AI agent。

agent 会读取远程安装说明，把 tarot、iching、xiaoliuren、bazi 复制到 skill 目录，并验证脚本。

Install Oraclebone for this agent: https://raw.githubusercontent.com/sapuyou45-bit/oraclebone/main/docs/install.md

也可以直接装到 Claude 风格的本地 skills 目录：

curl -fsSL https://raw.githubusercontent.com/sapuyou45-bit/oraclebone/main/install.sh | bash

默认目标：~/.claude/skills。设置 AI_SKILLS_DIR 可安装到其他 agent 的 skill 目录。

安全边界

象征性反思，不是确定性预言。