corpus

mcp.wheelofheaven.world

Wheel of Heaven 语料库的只读 MCP 服务。 它封装了位于 api.wheelofheaven.world 的静态 JSON API，让 AI Agent 能够搜索和检索语料库及其完整的认识论元数据（主张类型、编辑审校轮次、引文）。

设计原理和工具接口规范：位于组织的 .claude 仓库中的 .claude/plans/strategy-mcp-server.md。

端点

• /mcp — Streamable HTTP（规范端点）
• /sse — 旧版 SSE 传输
• / — 服务信息（JSON）

安装

远程（推荐——无需在本地运行任何内容）：

claude mcp add --transport http wheel-of-heaven https://mcp.wheelofheaven.world/mcp

通过 npm 使用本地 stdio（@wheelofheaven/mcp）：

npx -y @wheelofheaven/mcp

注册表条目：官方 MCP 注册表中的 world.wheelofheaven.mcp/corpus。

工具

事实层——以来源为依据的数据，不做任何解释：

工具	用途
search_corpus	对维基、时间线、馆藏书籍、文章和新闻进行全文模糊搜索（约 290 篇文档；先按词元进行 AND 匹配，未命中时回退到 OR 匹配）
get_entry	以 Markdown 格式获取一条维基、时间线、文章或新闻条目，包含 claim_type、editorial_pass、带类型的相关内容关联和规范引文 URL；通过 lang 支持 9 种语言
get_passage	获取数字化原始文献文本的一章，内容为带稳定引用 ID（例如 GEN-1:26）的编号段落；ref 可筛选到单节
get_source	按稳定 ID 查找书目，或搜索书目——每条记录都包含来源计划分类（家族、立场、关系），其中也包括批判性来源
compare_traditions	获取比较数据集中的条目：洪水神话、神圣议会索引、神战交叉引用、世界时代、先知与宗教
query_graph	查询语料库中任意节点的带类型 1 跳自我网络（see_also、in_body、cites_source、same_tradition、same_age、comparison_of）

阐释层——明确标注为项目自身的解读：

工具	用途
get_interpretation	获取 Wheel of Heaven 框架对某个主题的解读（精选的上下文文档，或最接近的维基条目），并始终附带阐释层说明
get_method	获取编辑方法论：主张类型分类法、六来源规则、编辑审校轮次——说明如何权衡其他所有内容

元信息：

工具	用途
get_glossary_term	获取核心术语在网站全部 9 种语言中的译法（优先精确匹配 ID）

资源：6 份 /v1/context/* 叙述性文档（woh://context/{overview,hypothesis,terminology,timeline,sources,method}）以及 woh://llms.txt。

开发

npm install
npm run dev        # wrangler dev on :8787
npm run typecheck
npm run deploy     # wrangler deploy (needs Cloudflare auth)

该服务通过上游 API 实现无状态运行：每次工具调用都会获取 api.wheelofheaven.world/v1/…，并在每个隔离实例的内存中缓存约 600 KB 的搜索语料库 1 小时（与 API 的边缘缓存 TTL 一致）。

架构

• Cloudflare Workers + agents SDK（McpAgent Durable Object）
• src/server.ts — 与传输方式无关的工具注册（未来 npm stdio 构建将复用）
• src/api.ts — /v1/ 客户端和搜索语料库缓存
• src/html.ts — 将 body_html 确定性地转换为 Markdown

相关仓库

• api.wheelofheaven.world — 此服务封装的静态 JSON API
• www.wheelofheaven.world — 面向读者的网站
• core — 研究语料库（主张模型；v2 中的 get_claim 将在此实现）

许可证

CC0-1.0——与语料库本身相同。