SpiritWave Labs — Pentamancy Council MCP Server

SpiritWave Labs の Pentamancy Council（5つのオラクルによる占いエンジン）を、Model Context Protocol を介して AI エージェントに公開します。

ツール

consult_council

5つの古代オラクルを並行して参照し、そのリーディングを単一の統一された助言に統合します：

• Hafez — ペルシャのスーフィー詩（Fal-e Hafez）

• Tarot — ライダー・ウェイト78枚のデッキ、3枚のスプレッド

• Runes — エルダー・フサルク、3ルーン引き

• I Ching — 易経、コイン投げによる六芒星

• Geomancy — アラビアの `Ilm al-Raml、シールドチャート

サーバーは5つすべてを引き、それぞれを解釈し、統合します。実質的な質問—大きな決断、感情の岐路、精神的な方向性—に最適です。

入力: { question: string } (3–1000文字)

個別相談

consult_hafez、consult_tarot、consult_iching、consult_runes、consult_geomancy — それぞれがサーバー側で独自の伝統を引き、その伝統の声で解釈します。ツールの説明はエージェントが自分でルーティングするように書かれており、意図的にルーターツールはありません。

Related MCP server: Yijing Bazi MCP Server

支払い (x402)

初日から有料です。カウンシルリーディングは$0.50、個別オラクルは$0.10で、x402 protocol を介して Base 上の USDC で支払います：

• initialize、tools/list、通知 — 無料。接続、発見、価格の確認ができます。

• 支払いなしで有料ツールの tools/call を呼び出すと → HTTP 402 が返り、ボディに paymentRequirements が含まれます（スキーム exact、受取人アドレス、アトミック金額）。

• X-PAYMENT ヘッダー（署名付き EIP-3009 ペイロード）で再試行します。x402 Foundation facilitator が検証して決済し、呼び出しが続行され、決済レシートが X-PAYMENT-RESPONSE で返されます。

x402-fetch（または x402 対応クライアント）を使用するエージェントは、このフローを自動的に取得します。設定：X402_PAYEE、X402_FACILITATOR、X402_ENABLED（docker-compose.yml を参照）。

アーキテクチャ

これはシンプロキシです。MCP サーバーは JSON-RPC ツール呼び出しを受け取り、既存の SpiritWave Labs PHP API に転送します：

Agent → MCP server (this repo, Streamable HTTP) → PHP API (temple.php, individual oracle endpoints) → DeepSeek

占いエンジンは完全に PHP バックエンドにあります。このサーバーは MCP プロトコルレイヤーを追加するだけで、占いロジック自体は実装していません。

トランスポート

Streamable HTTP（リモートサーバー向けの MCP 標準）。単一エンドポイント：POST /mcp。

セットアップ

npm install
npm run build     # compile TypeScript
npm start         # run the compiled server
# or for development:
npm run dev       # run via tsx with hot reload

設定

ロードマップ

• フェーズ1（完了）： MCP スキャフォールド、6つのツール、mcp.spiritwavelabs.com にデプロイ（Docker、nginx の背後、2026-08-18 から稼働中）。

• フェーズ2： x402 支払いレイヤー — Coinbase CDP ファシリテーター（Base ネットワーク）を介した呼び出しごとの USDC 支払い。エージェントはリーディングごとに支払います。

• フェーズ3： レジストリ掲載 — 公式 MCP Registry、Smithery、Glama。

ライセンス

MIT © SpiritWave Labs