SpiritWave Labs — Pentamancy Council MCP Server

通过 Model Context Protocol 将 SpiritWave Labs 的 Pentamancy Council（五先知占卜引擎）暴露给 AI 代理。

工具

consult_council

并行咨询五位古代先知，并将其解读综合为一份统一建议：

• Hafez — 波斯苏菲诗歌（Fal-e Hafez）

• Tarot — Rider-Waite 78 张牌组，三张牌阵

• Runes — 古弗萨克文，三符文抽取

• I Ching — 《易经》，掷币成卦

• Geomancy — 阿拉伯 Ilm al-Raml，盾形图

服务器抽取全部五种，逐一解读，然后综合。最适合实质性问题的咨询——重大决策、情感十字路口、灵性方向。

输入： { question: string }（3–1000 字符）

单独咨询

consult_hafez、consult_tarot、consult_iching、consult_runes、consult_geomancy — 每种都在服务器端抽取各自传统并以其传统的声音进行解读。工具描述的设计使代理自行路由；刻意不设路由工具。

Related MCP server: Yijing Bazi MCP Server

支付（x402）

从第一天起即收费。每次 Council 解读 $0.50，每次单独先知 $0.10，通过 x402 协议 在 Base 网络上以 USDC 支付：

• initialize、tools/list、通知 — 免费。连接、发现、查看价格。

• 对付费工具调用 tools/call 而未支付 → HTTP 402，响应体包含 paymentRequirements（scheme 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

配置

路线图

• 第一阶段（已完成）： MCP 脚手架、六个工具，部署于 mcp.spiritwavelabs.com（Docker，nginx 之后，自 2026-08-18 起运行正常）。

• 第二阶段： x402 支付层——通过 Coinbase CDP facilitator（Base 网络）按次 USDC 支付。代理按次付费。

• 第三阶段： 注册表收录——官方 MCP Registry、Smithery、Glama。

许可证

MIT © SpiritWave Labs