I Ching

@pipeworx/i-ching

伝統的な三枚のコインまたは蓍草を使う方法で易を占うか、64 卦（文王序）を直接調べられます。各卦の卦辞、象辞、および六爻のテキストは、このパックのために独自に書かれたものです。

Pipeworx の一部です。AI エージェントを 1866 以上の稼働中のデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとの提携、同社による承認、または同社による公開はありません。

ツール

• cast_i_ching({ method?, question?, seed? }) — 六爻を占います（デフォルトはコイン、または蓍草）。本卦、変爻がある場合はそのテキスト、および変爻を反転させた後の之卦（変爻がない場合は null）を返します。seed は常に結果のトップレベルに返されます。同じ method とともに渡すと、まったく同じ占いを再現できます。meta には、引用用の共通チャンスエンジンのエンベロープ（seed、procedure、deck、source）が含まれます。これは、このパックファミリー全体で使われている規約（例：dice-roller）に準拠しています。question はそのまま返され、解釈されることはありません。呼び出し元のエージェントが卦と爻のテキストを読み、自ら結論を導きます。
• get_hexagram({ number?, name? }) — 文王序の番号（1～64）または名前（漢字、ピンイン、またはここで使用している英語の意訳）で指定した卦の全文を返します。
• search_hexagrams({ query }) — 名前とキーワードを対象に全文検索します（例：「雷」「忍耐」「退く」）。短い要約を返します。一致した卦の全文を取得するには、get_hexagram を使ってください。

認証

キーは不要です。上流サービス、API キー、COGS はありません。

コンテンツと出典

64 卦すべてがこのパック内にインラインで収録されています（src/hexagrams.ts、約 70 KB。workers/gateway/src/pack-baked-indexes.json に従ってコンテンツが KV に移される 150 KB のしきい値を大きく下回っています）。

• 文王序の卦番号、漢字名、ピンイン表記、六本の爻（下から上へ。爻は陽／実線または陰／破線です）、およびその八卦の構成は、本文のあらゆる版に共通して掲載されている伝統的な構造上の事実であり、いずれかの翻訳者の著作権で保護された表現ではありません。
• 英語の卦名、卦辞、象辞、および六本すべての爻辞は、このパックのために書かれた独自の表現です。各卦と爻の基礎となる意味の参照資料として、ジェームズ・レッグによる 1899 年の翻訳（「The Yi King」、Sacred Books of the East 第 16 巻）を使用しています。このパックでは、著作権が存続しているウィルヘルム／ベインズ訳（「The I Ching or Book of Changes」）や、その他の現代の商業翻訳の表現を一切転載していません。
• コイン投げの確率（6／7／8／9 が 1/8、3/8、3/8、1/8）と蓍草を使う方法の確率（1/16、5/16、7/16、3/16）は、それぞれの伝統的な数え方から得られる標準的かつ十分に文書化された結果であり、誰かの表現ではありません。
• 意味は伝統に基づくものであり、呼び出し元のエージェントが独自の質問に合わせて解釈します。すべてのツールの説明にこの点が記載されているため、結果はツールが提供する助言ではなく、推論のための構造化された資料として示されます。

ランダム性

モデルがコインを投げるふりをするのではなく、共通チャンスエンジン（@pipeworx/shared の makeRng／rollWeighted）を使って真のランダム性を実現しています。cast_i_ching の seed は省略可能で、常に返されるため、同じシードと方法を使えば、まったく同じ占いを再現できます。ここではセッションやデッキの引き出し状態を使用しません。タロットやランダムテーブルのパックとは異なり、毎回の占いは独立した六本の爻を振る単一の自己完結した処理です。そのため、呼び出し間で引き継ぐものはなく、このパックは KV 注入を要求しません。

エラー

1～64 の範囲外の卦番号、一致するものがない名前、または検索結果がない検索クエリは、いずれも有効範囲を示すか、試せる例やキーワードを提示する、明示的なエラーになります。結果が黙って空になることはありません。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "i-ching": {
      "url": "https://gateway.pipeworx.io/i-ching/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/i-ching/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共有ツールがおよそ 30 個表示されます。接続の initialize 応答に正確な対象範囲が示されており、その日の状況を確認するにはこれが最も信頼できる情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックでは扱えない質問にも、カタログ全体から適切なものを呼び出す ask_pipeworx 経由で回答できます。別の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックのエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

または、Pipeworx ゲートウェイ全体に接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1866 以上のデータソースにアクセスします。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/cast_i_ching \
  -H 'Content-Type: application/json' \
  -d '{"method":"coins","question":"Should we ship the chance-pack family?","seed":"pipeworx-iching-smoke-1"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/cast_i_ching を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も必要ありません。

{
  "mcpServers": {
    "i-ching": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-i-ching"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-i-ching

stdin/stdout 経由で MCP をやり取りし、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、ゲートウェイ全体でも使用できます。

ask_pipeworx({ question: "your question about I Ching data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT