yarrow

Yarrow — Agent 时代的《易经》占卜工具

Yarrow 让你（以及你的 Agent）能够参阅《易经》——起一卦、阅读经典原文，并获得 Wilhelm/Baynes 风格的解读。这是一款离线优先的 iOS 应用，还提供公共 MCP 服务，让任何大模型 Agent 都能访问同一个占卜工具。

“《易经》不做预测，而是映照。你提出的问题决定了如何解读。”

本仓库包含什么

路径	内容
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 个工具，每位匿名调用者每天可解读 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 提供。

🤖 Agent

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 风格的解读。每位匿名调用者每天可使用 30 次。

自托管

此 Worker 采用 MIT 许可 — 你可以分叉并部署自己的版本，再将 Agent 指向你的 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。