Cafe MCP server

cafe-mcp

<!-- mcp-name: io.github.dangamsoft/cafe-mcp -->

CAFE = Cross-weighted Analysis of the Five Elements

Public OWL ontology for Korean Saju (사주명리학),

with live MCP integration (v0.6.0) via the CAFE engine.

✅ v0.6.0 — The MCP server is live. A local (stdio) server exposing

5 free birth-chart tools — sajuchart, ohaengbalance, gyeokguk,

eumyangjohu, yongshincandidates — alongside the public W3C OWL

ontology. See Install below.

What this is

A formal W3C OWL 2 ontology for Korean Saju (사주명리학), grounded in classical Myeongli theory and six canonical treatises. Released under CC BY 4.0 for academic use, system integration, and downstream development.

The ontology is the public layer of the CAFE engine — a deterministic Saju analysis system combining classical theory with ML-based yongshin classification.

W3C OWL 2 온톨로지 형태로 공개된 한국 사주명리학 도메인 모델입니다. 6대 고전(적천수·자평진전·난강망·궁통보감·연해자평·삼명통회)에 근거하며, CC BY 4.0으로 학술·시스템 통합·후속 개발에 자유롭게 사용할 수 있습니다.

이 온톨로지는 CAFE 엔진의 공개 레이어입니다 — 결정적(deterministic) 사주 분석 시스템으로, 명리학 고전 이론과 ML 기반 용신 분류를 결합합니다.

Install (MCP server)

The server runs locally over stdio and talks to the hosted CAFE backend — no API key, no local engine, no database required.

Claude Desktop — add to claudedesktopconfig.json:

{
  "mcpServers": {
    "cafe-mcp": {
      "command": "npx",
      "args": ["-y", "@dangamsoft/cafe-mcp"]
    }
  }
}

Cursor — add the same mcpServers entry to ~/.cursor/mcp.json.

Then ask, e.g. "Show my saju for 1990-01-15 10:30, male."

Tools (5, free)

All tools take birth (YYYYMMDDHHMM) and gender (0 = female, 1 = male); name and is_lunar are optional.

The AI-selected final Yongshin (91.1%-accuracy classifier), full Yongshin

report, NCODE personality profile and AI naming are part of the

24Plus service and are not exposed here.

Custom backend: set CAFEMCPAPIURL (the server POSTs to ${CAFEMCPAPIURL}/try/panels; default https://24plus.ai.kr/api).

Ontology

• 1,711 RDF triples · SPARQL-queryable · W3C OWL 2 conformant
• Models:
• 60갑자 (Sexagenary cycle)
• 75 sinsal (special-star annotations)
• 18 patterns — 정격 10 + 특수격 8
• 5 yongshin types — 격국·억부·병약·조후·통관
• 12 life stages (12운성)
• Grounded in 6 classical treatises:
• 적천수 (Diqianshui)
• 자평진전 (Zipingzhenquan)
• 난강망 (Lanjiangwang)
• 궁통보감 (Qiongtongbaojian)

See ontology/ for module structure, SPARQL examples, and the integrated turtle file (cafe-ontology.ttl).

CAFE engine performance

The CAFE engine — the inference system this ontology models — operates inside the 24Plus platform. Validated performance on 5-class yongshin classification (목/화/토/금/수, 5-fold cross-validated):

Shortened. The full README is on GitHub.