@shaozhengkun/yarrow-mcp

Stdio MCP bridge to the Yarrow I-Ching oracle.

For clients that only speak stdio MCP — Codex CLI, Hermes, older Claude Desktop, custom agents — this package wraps mcp-remote and pins it to the public Yarrow HTTP MCP endpoint so you don't need to remember the URL or the flags.

Use it

Codex CLI

~/.codex/config.toml:

[mcp_servers.yarrow]
command = "npx"
args = ["-y", "@shaozhengkun/yarrow-mcp"]

Claude Desktop (older versions, no native HTTP MCP)

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "yarrow": {
      "command": "npx",
      "args": ["-y", "@shaozhengkun/yarrow-mcp"]
    }
  }
}

Hermes per-profile

mcp_servers:
  yarrow:
    command: /opt/homebrew/bin/npx
    args:
      - -y
      - "@shaozhengkun/yarrow-mcp"
    tools:
      prompts: false
      resources: false

Bare invocation

npx @shaozhengkun/yarrow-mcp

Speaks stdio MCP on stdin/stdout; useful for piping into a custom client.

Tools you get

• cast_hexagram — cast a hexagram (coins / yarrow stalks / random), seedable.
• lookup_hexagram — fetch a hexagram's classical commentary (杨天才 / 朱熹 / 断易天机 / 白话).
• divine — one-shot Wilhelm/Baynes-style reading. 30/day per anonymous caller.

Self-host

If you've forked and deployed your own Worker, point this bridge at it:

YARROW_MCP_URL=https://your.workers.dev/mcp npx @shaozhengkun/yarrow-mcp

License

MIT. The underlying classical I-Ching sources are public domain.