I Ching

@pipeworx/i-ching

使用传统的三枚铜钱法或蓍草法进行《易经》占卜，也可以直接查阅 64 卦中的任意一卦（文王卦序）。每一卦的卦辞、象辞和六爻爻辞，均为本工具包原创撰写。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1866+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方无关联，未经其认可，也非由其发布。

工具

• cast_i_ching({ method?, question?, seed? }) — 占出六爻（默认使用铜钱法，也可使用蓍草法），返回本卦、变爻及其爻辞，以及变爻翻转后得到的之卦（若无变爻则为 null）。seed 始终会在结果的顶层返回；传回相同的 method，即可重现完全相同的占卜结果。meta 包含通用的随机引擎元数据（seed、procedure、deck、source），便于引用；这一格式遵循本系列工具包的通用约定（例如 dice-roller）。question 会原样返回，绝不会被解读——调用方 Agent 会阅读卦辞和爻辞，并自行得出结论。
• get_hexagram({ number?, name? }) — 根据文王卦序编号（1-64）或名称（中文、拼音或本文采用的英文释义）获取某一卦的完整内容。
• search_hexagrams({ query }) — 按名称和关键词进行全文搜索（例如 “thunder”、“patience”、“withdrawal”）；返回简短摘要。要查看匹配卦象的完整内容，请使用 get_hexagram。

身份验证

无需密钥。无需上游服务、API 密钥或 COGS。

内容与来源

本工具包内置全部 64 卦（src/hexagrams.ts，约 70 KB——远低于内容转存至 KV 的 150 KB 阈值，参见 workers/gateway/src/pack-baked-indexes.json）。

• 文王卦序编号、中文名称、拼音转写、六爻（二进制形式；自下而上排列，每爻为阳爻／实线或阴爻／断线）及其卦象组成，都是在各版《易经》中通用的传统结构性事实，并非任何译者受版权保护的表达。
• 英文卦名、卦辞、象辞和全部六条爻辞均为原创文本，专为本工具包撰写。每一卦及其爻辞的含义以 James Legge 于 1899 年出版的译本（《The Yi King》，Sacred Books of the East 第 16 卷）作为公有领域参考。本工具包不会复现 Wilhelm/Baynes 的译文（《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），都是各传统计数方法的标准且有充分文献记录的结果，并非任何人的独创表达。
• 卦意源自传统；调用方 Agent 会针对自己的问题加以解读。每个工具描述都明确说明了这一点，因此结果呈现为供推理使用的结构化材料，而非工具给出的建议。

随机性

本工具通过共享随机引擎（@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