corpus

mcp.wheelofheaven.world

Wheel of Heaven コーパス用の読み取り専用MCPサーバーです。 api.wheelofheaven.world の静的 JSON API をラップし、AI エージェントが認識論的メタデータ（主張の種類、編集工程、引用情報）をすべて含むコーパスを検索・取得できるようにします。

設計方針とツールの仕様については、組織の .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	wiki、タイムライン、図書館の書籍、記事、ニュースを対象としたあいまいな全文検索（約290件のドキュメント。トークンの AND 検索と、該当なしの場合の OR 検索）
get_entry	wiki／タイムライン／記事／ニュースのエントリーを、claim_type、editorial_pass、型付きの関連コンテンツエッジ、正規の引用 URL を含む Markdown として取得します。lang による9言語対応
get_passage	デジタル化された一次資料テキストの章を、安定した参照 ID（例：GEN-1:26）付きの番号付き段落として取得します。ref を指定すると、1つの節に絞り込めます
get_source	安定した ID または検索語による書誌情報の検索。すべてのレコードに、資料プログラムの分類（系統、立場、関係性）が含まれ、批判的な資料も対象です
compare_traditions	比較データセットの行を取得します：flood-myths、divine-council-index、theomachy-crossrefs、world-ages、prophets-and-religions
query_graph	コーパス内の任意のノードについて、型付きの1ホップ・エゴネットワークを取得します（see_also、in_body、cites_source、same_tradition、same_age、comparison_of）

解釈レイヤー — プロジェクト独自の読み解きであることを明示しています：

ツール	目的
get_interpretation	Wheel of Heaven フレームワークによるトピックの読み解き（厳選されたコンテキストドキュメント、または最も近い wiki エントリー）。常に解釈レイヤーであることを示す注意書きが付属します
get_method	編集方法論：主張の種類の分類、6資料ルール、編集工程など、その他すべての情報の評価方法

メタ：

ツール	目的
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の検索コーパスを 各 isolate のメモリ内に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 — 研究コーパス（主張モデル。get_claim は v2 で追加予定）

ライセンス

CC0-1.0 — コーパス自体と同じです。