Oraclebone

Name: Oraclebone
Author: sapuyou45-bit

ローカル

github.com/sapuyou45-bitゲーム・エンタメ69 週間前に更新

リポジトリ

Oraclebone について

Oracleboneは、AIエージェント向けのオープンソース占術ツールキットです。タロット、易経、小六壬、八字の結果をローカルスクリプトで生成し、エージェントが解釈するため、結果の生成と象徴的な内省を分離できます。

主な機能

01監査可能なタロットのドロー
02易経の卦の生成
03小六壬の占断
04八字チャートの生成
05監査メタデータ付きJSON出力
06再利用可能な解釈テンプレート

活用シーン

01タロットによる意思決定の内省
02戦略検討のための易経占い
03出生日時からの八字チャート生成

MCP 対応

内蔵MCPサーバーは、タロット、易経、小六壬、八字、解釈テンプレートの5つのツールを公開します。サーバーが監査可能なスクリプトをローカルで実行し、モデルが解釈する結果を返します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "sapuyou45-bit-oraclebone": {
      "command": "uvx",
      "args": [
        "oraclebone"
      ]
    }
  }
}

起動コマンドuvx oraclebone

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypioraclebone8.2.0stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
deck	enum	いいえ	大アルカナのみ（22 枚）、または全 78 枚のデッキ。major \| full
seed	string	いいえ	省略可。テスト／デモ専用。
spread	enum	いいえ	single \| three-card \| decision \| creative \| project
reversals	boolean	いいえ

詳細

Oraclebone

骨にひびが入り、モデルが読み解く。

uvx oraclebone-mcp · ホームページ · v8.2.0

三千年前、殷の王たちは占いの結果を骨に刻みました。これは、占いの実践を記録した最初の監査可能な記録です。Oraclebone は、同じ規律を AI エージェントにもたらします。監査済みのスクリプトが占いの結果、卦、柱を生成し、モデルは与えられた内容を解釈するだけです。結果を捏造することはありません。

English | 简体中文 | 日本語

デモ

🔮 ai-divination-skills（v8.0.0 で名称変更。旧 PyPI パッケージは更新を停止しています。代わりに oraclebone をインストールしてください）として知られていた、AI エージェント向けオープンソース占術ツールキットです。

oraclebone は、タロット、易、小六壬、そして今後追加される象徴体系のための実用的なスキル集です。監査可能な乱数、明確な手法の境界、再利用可能な解釈テンプレートを必要とするエージェントのワークフロー向けに構築されています。

このプロジェクトでは、占いを決定論的な予測ではなく、象徴的な推論と内省として扱います。

⚡ AI エージェントにワンラインでインストール

これを AI エージェントに貼り付けてください。

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

または、Claude 形式のローカルスキルとして直接インストールしてください。

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

デフォルトのインストール先は ~/.claude/skills です。別のエージェントのスキルディレクトリを使う場合は、AI_SKILLS_DIR を設定してください。

✨ 概要

AI 占いのプロンプトの多くでは、モデルが結果を捏造します。このリポジトリでは、2 つの役割を分離しています。

ローカルスクリプトが、カードの展開、卦、または小六壬の位置を生成します。
AI エージェントは、明確な安全上の境界に従って、生成された結果を解釈します。

これにより、占断をテスト、再現、監査しやすくなり、さまざまなエージェントで再利用できます。

🧭 方法論の厳密さ

基本原則はシンプルです。スクリプトまたはユーザーが提示した実際の占いの結果によって占いの結果を生成し、AI はその結果を解釈します。AI が占いの結果を生成することはありません。

これは、占いの有効性を科学的に証明するものではありません。象徴的な推論のための、より厳密なワークフローです。

実際の占いでは、デフォルトでシステム乱数を使用します
シード付きモードはテストと再現可能なデモにのみ使用します
伝統的な手法とその限界を、スキルごとに記録します
JSON 出力には、手法を監査するために十分なメタデータが含まれます
近似モードでは、伝統的な手法であるかのように装わず、警告を出力します

🌐 多言語ドキュメント

GitHub Pages サイトには、6 言語の切り替え機能が用意されています — 简体中文、English、日本語、Português、한국어、Español。デフォルトではブラウザーの言語に従い、手動で選んだ言語を記憶します。

公開サイトを開く

ローカルでのプレビュー：

python3 -m http.server 8000 -d docs

公開サイト：

https://sapuyou45-bit.github.io/oraclebone/

🧩 含まれるスキル

スキル	機能	スクリプト
`tarot`	振り返り、意思決定、創作上の行き詰まり、プロジェクトの見直しのためにタロットカードを引きます。	`skills/tarot/scripts/draw.py`
`iching`	6 爻の易卦を立て、本卦と変卦を示します。	`skills/iching/scripts/cast.py`
`xiaoliuren`	月に基づく数値、または代替としてグレゴリオ暦の時刻から小六壬を立てます。	`skills/xiaoliuren/scripts/cast.py`
`bazi`	グレゴリオ暦の生年月日時から八字（四柱推命）の命式を立てます。オプションの `lunar-python` エクストラが必要です。	`skills/bazi/scripts/cast.py`

🚀 クイックスタート

PyPI からインストールします：

pip install oraclebone

または、チェックアウトしたリポジトリからインストールします：

pip install .

開発中は編集可能モードを使用します：

pip install -e .

すべての方式で同じコマンドを使用します：

ai-divination tarot --deck major --spread three-card --reversals
ai-divination iching --method yarrow
ai-divination xiaoliuren --method numbers --month 3 --day 12 --hour 7

エージェント向けの解釈テンプレートを取得します：

ai-divination template tarot

Python API を直接使用します：

from oraclebone.tarot import draw
from oraclebone.iching import cast
from oraclebone.xiaoliuren import cast_numbers

基盤となるスクリプトを直接実行することもできます：

python3 skills/tarot/scripts/draw.py --deck major --spread three-card --reversals
python3 skills/iching/scripts/cast.py --method coins
python3 skills/iching/scripts/cast.py --method yarrow
python3 skills/xiaoliuren/scripts/cast.py --method numbers --month 3 --day 12 --hour 7

再現可能なデモにはシードを使用します：

python3 skills/tarot/scripts/draw.py --spread decision --seed demo
python3 skills/iching/scripts/cast.py --method yarrow --seed demo

すべてのスクリプトは JSON を出力します。

📦 エージェントスキルとしてインストール

AI エージェントによるセットアップには、リモートインストール手順書を使用します：

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

シェルから直接インストールする場合：

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

インストーラーはデフォルトで tarot、iching、xiaoliuren を ~/.claude/skills にコピーします。別のエージェントを対象にするには、実行前に AI_SKILLS_DIR を設定してください。

手動でインストールする場合は、必要なフォルダーをエージェントのスキルディレクトリにコピーするだけです：

mkdir -p ~/.claude/skills
cp -R skills/tarot ~/.claude/skills/tarot
cp -R skills/iching ~/.claude/skills/iching
cp -R skills/xiaoliuren ~/.claude/skills/xiaoliuren

各スキルは単独で動作します：

skills/name/
  SKILL.md
  agents/openai.yaml
  scripts/
  references/

1 つのスキルだけを使う場合は、リポジトリ全体ではなく、個々のフォルダーをインストールしてください。

各スキルのスクリプトは、単一フォルダーモードでも動作します。Python パッケージがインストールされている場合、スクリプトはパッケージのランタイムに処理を委譲します。スキルフォルダーだけがコピーされている場合は、そのスキルに同梱されたスタンドアロンスクリプトにフォールバックします。

ホストごとのアダプター

各スキルには、skills/<skill>/agents/ に 4 つのアダプターファイルが含まれています：

ホスト	ファイル	呼び出し方法
OpenAI / Codex スキル	`openai.yaml`	スキルのメタデータとブランドアイコン。
Claude Desktop / claude.ai プロジェクトスキル	`claude.yaml`	`ai-divination <skill>` を実行するツール仕様。
Gemini CLI / Gemini Extensions	`gemini.yaml`	同じ CLI を実行する拡張機能マニフェスト。
Cursor	`cursor.mdc`	「占い結果を決してでっち上げない」という厳格なルールを記したファイル。

4 つのアダプターはいずれも、監査済みの同じ ai-divination <skill> CLI を経由するため、エージェントホストが結果をでっち上げることはありません。

🧠 Claude Desktop / Codex / 任意の MCP ホストから使用する

oraclebone には、組み込みの MCP サーバー（ai-divination-mcp）が含まれています。 Model Context Protocol に対応する任意のホスト — Claude Desktop、Codex、 Continue、Cursor — は、設定を 1 行追加するだけで接続でき、モデルは 5 つのツールを利用できます： tarot_draw、iching_cast、xiaoliuren_cast、bazi_cast、interpretation_template。

モデルが占い結果をでっち上げることはありません。サーバーが監査済みスクリプトをローカルで実行します。

Claude Desktop

パッケージを一度インストールします：

pip install oraclebone

次に、~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します：

{
  "mcpServers": {
    "divination": {
      "command": "ai-divination-mcp"
    }
  }
}

Claude Desktop を再起動します。「私の決断のためにタロットカードを 3 枚引いて」と尋ねると、Claude は tarot_draw を呼び出して JSON 出力を解釈します。

Codex / Continue / Cursor

MCP 対応ホストは、いずれも同じ方法で設定できます。サーバーは、サードパーティー依存関係なしで、stdio 経由の JSON-RPC 2.0 を使用します。

クライアントごとのセットアップガイド

各ホスト向けのコピー＆ペースト可能な JSON 設定とプロンプトの例：

🤖 エージェントの動作

各スキルは、エージェントに次のことを指示します。

具体的な占断結果を生成するか、受け取る
必要な場合にのみ簡潔な参考資料を読む
共通の応答仕様に従って解釈する
断定、宿命論、専門家としての助言を避ける

共通のガイダンスは、以下にあります。

shared/methodology.md
shared/interpretation-protocol.md
shared/response-contract.md
shared/randomness-protocol.md
shared/safety-policy.md
shared/interpretation-style.md

🧪 例

examples/tarot-decision.md
examples/iching-strategy.md
examples/xiaoliuren-daily.md

🛡️ 安全上の境界

これらのスキルは、医療、法律、金融、危機に関するガイダンスを提供するものではありません。

良い占断では、次のことを行います。

結果を象徴的な振り返りとして提示する
述べる内容を生成された結果と結び付ける
ユーザーの主体性を尊重する
小さく、後戻りできる次のステップを提案する
不確実性を明確に示す

プロジェクトの方針全体については、ETHICS.md を参照してください。

🛠️ 開発

Python 3 以外に、実行時の依存関係は必要ありません。

テストを実行します。

python3 -m unittest discover -s tests

現在のカバレッジでは、以下を確認しています。

統一 CLI のルーティング
パッケージのみでの CLI 実行
インポート可能な Python API
単一フォルダーでのスキル実行
スキルのメタデータとアセットの仕様
解釈プロトコルのテンプレート
タロットのスプレッド出力
易の占断構造と手動で指定した爻
小六壬における数値と時刻のフォールバック動作

💬 コミュニティ

リリース：https://github.com/sapuyou45-bit/oraclebone/releases
ロードマップ：ROADMAP.md
ディスカッション：https://github.com/sapuyou45-bit/oraclebone/discussions
課題：good first issueを選ぶか、new-skillを提案してください
セキュリティ：脆弱性を非公開で報告する方法については、SECURITY.mdを参照してください

🗺️ ロードマップ

近日中：

公開パッケージのワークフローを追加する
CI でのスキル自動検証を拡充する
各 MVP スキルの参考資料を充実させる
占断の例を追加する
エージェント統合の例を追加する

今後：

meihua
liuyao
runes
numerology
astrology

📄 ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: sapuyou45-bit
言語: python
バージョン: 8.2.0
トランスポート: stdio
掲載日: 2026年8月23日
最終更新: 9 週間前
公式 Registry: io.github.sapuyou45-bit/oraclebone

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Oraclebone

Oraclebone について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Oraclebone

骨にひびが入り、モデルが読み解く。

⚡ AI エージェントにワンラインでインストール

✨ 概要

🧭 方法論の厳密さ

🌐 多言語ドキュメント

🧩 含まれるスキル

🚀 クイックスタート

📦 エージェントスキルとしてインストール

ホストごとのアダプター

🧠 Claude Desktop / Codex / 任意の MCP ホストから使用する

Claude Desktop

Codex / Continue / Cursor

クライアントごとのセットアップガイド

🤖 エージェントの動作

🧪 例

🛡️ 安全上の境界

🛠️ 開発

💬 コミュニティ

🗺️ ロードマップ

📄 ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？