yarrow

Yarrow — エージェント時代の易経占

Yarrow を使うと、あなたやエージェントが『易経』を参照できます。卦を立て、古典資料を読み、Wilhelm/Baynes 風の考察を得られます。オフラインファーストの iOS アプリに加え、あらゆる LLM エージェントが同じ易占にアクセスできる公開 MCP サーバーを提供します。

「易経は予言するのではなく、映し出すものです。持ち込む問いが、読み解きを決めます。」

このリポジトリの内容

パス	内容
src/	Cloudflare Workers のソース — 公開 MCP エンドポイントと iOS アプリ向けプロキシ
src/data_hexagrams.json	64 卦と、古典資料の二言語テキスト（杨天才 / 朱熹 / 断易天机 / 白话题解）
src/hexagram.ts	決定論的な卦立て（コイン／筮竹／ランダム）、FNV-1a + mulberry32 を使ったシード設定
src/mcp.ts	MCP JSON-RPC 2.0 ハンドラー（3 つのツール、匿名の呼び出し元あたり 1 日 30 回の占い）
.claude-plugin/marketplace.json	Claude Code / Codex プラグインマーケットプレイスのマニフェスト
skills/yarrow/SKILL.md	Yarrow スキル — あらゆる Claude Code または Codex のインストール環境に組み込み可能
npm/yarrow-mcp/	@shaozhengkun/yarrow-mcp — HTTP MCP に対応していないクライアント向けの stdio ブリッジ
submissions/	modelcontextprotocol/servers、Smithery、mcp.run 向けの草稿
INTEGRATIONS.md	Claude Code / Claude Desktop / Codex / Hermes 向けのコピー＆ペースト可能な設定

iOS のソースは yarrow-ios に別途あります（TODO）。

ユーザー向け

📱 iOS アプリ

App Store からダウンロード → · $4.99 · iOS 17 以降 · トラッキングなし、アカウント不要。

64 卦すべてと古典注釈はアプリに含まれています。AI による読み解きは任意で、この Worker を通じて実行されます。

🤖 エージェント

Claude Code — プラグインをインストールします。

claude plugin marketplace add https://github.com/shaozhengkun123/yarrow
claude plugin install yarrow

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "yarrow": { "url": "https://yarrow-oracle.shaozhengkun.workers.dev/mcp" }
  }
}

Codex CLI / Hermes / 旧バージョンの Claude Desktop — stdio ブリッジを使います。

npx @shaozhengkun/yarrow-mcp

または、クライアントの設定に固定します。すべてのプラットフォームについては INTEGRATIONS.md をご覧ください。

curl を使う場合 —

curl -s -X POST https://yarrow-oracle.shaozhengkun.workers.dev/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"divine",
    "arguments":{"question":"Should I take the new job?","locale":"en"}
  }}'

MCP ツール

ツール	用途
cast_hexagram	コインを投げる／筮竹で卦を立てます。本卦と爻、変卦、およびすべてのメタデータを返します。seed を渡すと決定論的になります。
lookup_hexagram	卦の古典テキストを取得します。Wilhelm 風の見出し、卦辞、象伝、そして杨天才 / 朱熹 / 断易天机 / 白话の注釈が含まれます。
divine	一度の呼び出しで占います。卦を立て、参照し、資料に基づいた Wilhelm/Baynes 風の考察を生成します。匿名の呼び出し元あたり 1 日 30 回までです。

セルフホスト

この Worker は MIT ライセンスです。フォークして独自にデプロイし、エージェントの接続先を自分の URL に設定してください。

git clone https://github.com/shaozhengkun123/yarrow
cd yarrow
npm install
npx wrangler login
npx wrangler kv:namespace create QUOTA          # copy id into wrangler.toml
echo -n '<your OpenAI-compatible chat URL>' | npx wrangler secret put PROXY_URL
echo -n '<your API key>'                   | npx wrangler secret put PROXY_KEY
npx wrangler deploy

エンドポイントは https://yarrow-oracle.<your-subdomain>.workers.dev になります。

境界

Yarrow は予測ではなく、内省のためのものです。Worker に組み込まれたシステムプロンプトは、次の依頼を拒否します。

• 占い／具体的な未来予測
• 医療、法律、金融に関する助言
• 「これから何が起きるかを明かしてほしい」という依頼

古典的な語り口は率直で、枠組みはユング心理学に基づいています。iOS アプリでも MCP でも、これが私たちの定める境界です。

ライセンス

コードは MIT ライセンスです。古典資料はパブリックドメインです。LICENSE をご覧ください。