SpiritWave Labs — Pentamancy Council MCP 서버

SpiritWave Labs Pentamancy Council(5개 오라클 점술 엔진)을 Model Context Protocol을 통해 AI 에이전트에 노출합니다.

도구

consult_council

다섯 개의 고대 오라클을 병렬로 참고하고 그 결과를 하나의 통합된 조언으로 종합합니다:

• Hafez — 페르시아 수피 시(Fal-e Hafez)

• Tarot — Rider-Waite 78장 카드 덱, 3장 스프레드

• Runes — Elder Futhark, 3루네 드로우

• 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 상담 1회 $0.50, 개별 오라클 1회 $0.10, x402 프로토콜을 통한 Base 네트워크 USDC 결제:

• initialize, tools/list, 알림 — 무료. 연결, 탐색, 가격 확인이 가능합니다.

• 결제 없이 유료 도구에 tools/call 호출 → 본문에 paymentRequirements가 포함된 HTTP 402 (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

구성

로드맵

• 1단계 (완료): MCP 스캐폴드, 6개 도구, mcp.spiritwavelabs.com에 배포(Docker, nginx 뒤, 2026-08-18부터 정상 작동).

• 2단계: x402 결제 계층 — Coinbase CDP facilitator(Base 네트워크)를 통한 호출당 USDC 결제. 에이전트가 상담당 비용을 지불합니다.

• 3단계: 레지스트리 등록 — 공식 MCP Registry, Smithery, Glama.

라이선스

MIT © SpiritWave Labs