Skip to content

dangamsoft/cafe-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cafe-mcp

CAFE = Cross-weighted Analysis of the Five Elements

Public OWL ontology for Korean Saju (사주명리학), with planned MCP integration via the CAFE engine.

MCP License W3C OWL 2 Ontology Version

⚠️ v0.5.x preview — This release publishes the public W3C OWL ontology and reserves the package name. The working MCP server (cafe_basic / cafe_analysis tools) and public API launch with v0.6.0 (planned 2026 Q2). Star the repo to be notified.


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 기반 용신 분류를 결합합니다.


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)
    • 연해자평 (Yuanhaiziping)
    • 삼명통회 (Sanmingtonghui)

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):

Metric Result
Accuracy 91.10%
F1-Score (Macro) 91.08%
Precision (Macro) 91.16%
Recall (Macro) 91.10%
ROC AUC (Macro) 97.76%

Random baseline = 20% (5 classes). 4.56× better than random. ML ensemble with weighted voting and probability calibration.

The engine itself remains proprietary; the ontology models the domain structure it operates on.


Roadmap

  • v0.5.x — Public ontology + name reservation (current)
  • v0.6.0 (planned 2026 Q2) — Working MCP server with cafe_basic / cafe_analysis tools, public API endpoint, tier-based pricing
  • v0.7+ — Multi-language explanation layers, additional analysis modes

Note on East Asian Myeongli traditions

This MCP focuses on the Korean Myeongli (사주명리학) tradition, which shares its classical roots — 子平眞詮 (Zipingzhenquan), 滴天髓 (Diqianshui), 窮通寶鑑 (Qiongtongbaojian), 淵海子平 (Yuanhaiziping), 三命通會 (Sanmingtonghui), 欄江網 (Lanjiangwang) — with the Chinese Bazi (八字) tradition.

Romanization uses Korean Revised Romanization (e.g., Yongshin, Sinsal). Hanja (정자) is preserved throughout the ontology.

본 MCP는 한국 명리학(사주명리학) 전통에 기반하며, 중국 八字 전통과 6대 고전(자평진전·적천수·궁통보감·연해자평·삼명통회·난강망)을 공유합니다.


Documentation


Built by

Dangamsoft (단감소프트) — Korean AI company specializing in classical East Asian knowledge systems.

🌐 https://24plus.ai.kr


License

  • Code (when published in v0.6.0): Apache 2.0
  • Public OWL ontology (ontology/): CC BY 4.0

The CAFE inference engine, scoring algorithms, ML model weights, and interpretation templates remain proprietary.

About

Korean Saju (Four Pillars) MCP server for Claude, ChatGPT, and AI agents

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors