{
  "markdown": "# cafe-mcp\n\n<!-- mcp-name: io.github.dangamsoft/cafe-mcp -->\n\n> **CAFE = Cross-weighted Analysis of the Five Elements**\n>\n> Public OWL ontology for Korean Saju (사주명리학),\n> with live MCP integration (v0.6.0) via the CAFE engine.\n\n[![MCP](https://img.shields.io/badge/MCP-live%20v0.6.3-brightgreen.svg)](https://modelcontextprotocol.io)\n[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](LICENSE)\n[![W3C OWL 2](https://img.shields.io/badge/W3C-OWL%202-orange.svg)](https://www.w3.org/TR/owl2-overview/)\n[![Ontology](https://img.shields.io/badge/Ontology-1%2C711%20triples-brightgreen.svg)](./ontology/)\n[![Version](https://img.shields.io/badge/Version-0.6.3-green.svg)](#)\n\n> ✅ **v0.6.0** — The MCP server is live. A local (stdio) server exposing\n> **5 free birth-chart tools** — `saju_chart`, `ohaeng_balance`, `gyeokguk`,\n> `eumyang_johu`, `yongshin_candidates` — alongside the public W3C OWL\n> ontology. See **[Install](#install-mcp-server)** below.\n\n---\n\n## What this is\n\nA formal W3C OWL 2 ontology for Korean Saju (사주명리학), grounded in\nclassical Myeongli theory and six canonical treatises. Released under\nCC BY 4.0 for academic use, system integration, and downstream development.\n\nThe ontology is the public layer of the **CAFE engine** — a deterministic\nSaju analysis system combining classical theory with ML-based yongshin\nclassification.\n\nW3C OWL 2 온톨로지 형태로 공개된 한국 사주명리학 도메인 모델입니다.\n6대 고전(적천수·자평진전·난강망·궁통보감·연해자평·삼명통회)에 근거하며,\nCC BY 4.0으로 학술·시스템 통합·후속 개발에 자유롭게 사용할 수 있습니다.\n\n이 온톨로지는 **CAFE 엔진**의 공개 레이어입니다 — 결정적(deterministic)\n사주 분석 시스템으로, 명리학 고전 이론과 ML 기반 용신 분류를 결합합니다.\n\n---\n\n## Install (MCP server)\n\nThe server runs locally over stdio and talks to the hosted CAFE backend —\n**no API key, no local engine, no database** required.\n\n**Claude Desktop** — add to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cafe-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dangamsoft/cafe-mcp\"]\n    }\n  }\n}\n```\n\n**Cursor** — add the same `mcpServers` entry to `~/.cursor/mcp.json`.\n\nThen ask, e.g. *\"Show my saju for 1990-01-15 10:30, male.\"*\n\n### Tools (5, free)\n\n| Tool | Returns |\n|------|---------|\n| `saju_chart` | Four Pillars chart — stems/branches, Ten Gods, Spirit Stars |\n| `ohaeng_balance` | Five Elements (五行) distribution |\n| `gyeokguk` | Chart structure/pattern (格局) |\n| `eumyang_johu` | Yin-Yang & Climate (陰陽·調候) balance |\n| `yongshin_candidates` | Classical 5-type Yongshin (用神) candidates |\n\nAll tools take `birth` (`YYYYMMDDHHMM`) and `gender` (0 = female, 1 = male);\n`name` and `is_lunar` are optional.\n\n> The AI-selected final Yongshin (91.1%-accuracy classifier), full Yongshin\n> report, NCODE personality profile and AI naming are part of the\n> 24Plus service and are **not** exposed here.\n\n**Custom backend:** set `CAFE_MCP_API_URL` (the server POSTs to\n`${CAFE_MCP_API_URL}/try/panels`; default `https://24plus.ai.kr/api`).\n\n---\n\n## Ontology\n\n- **1,711 RDF triples** · SPARQL-queryable · W3C OWL 2 conformant\n- Models:\n  - 60갑자 (Sexagenary cycle)\n  - 75 sinsal (special-star annotations)\n  - **18 patterns** — 정격 10 + 특수격 8\n  - 5 yongshin types — 격국·억부·병약·조후·통관\n  - 12 life stages (12운성)\n- Grounded in 6 classical treatises:\n  - 적천수 (Diqianshui)\n  - 자평진전 (Zipingzhenquan)\n  - 난강망 (Lanjiangwang)\n  - 궁통보감 (Qiongtongbaojian)\n  - 연해자평 (Yuanhaiziping)\n  - 삼명통회 (Sanmingtonghui)\n\nSee [`ontology/`](./ontology/) for module structure, SPARQL examples, and\nthe integrated turtle file (`cafe-ontology.ttl`).\n\n---\n\n## CAFE engine performance\n\nThe CAFE engine — the inference system this ontology models — operates\ninside the 24Plus platform. Validated performance on 5-class yongshin\nclassification (목/화/토/금/수, 5-fold cross-validated):\n\n| Metric                  | Result   |\n|-------------------------|----------|\n| Accuracy                | 91.10%   |\n| F1-Score (Macro)        | 91.08%   |\n| Precision (Macro)       | 91.16%   |\n| Recall (Macro)          | 91.10%   |\n| ROC AUC (Macro)         | 97.76%   |\n\nRandom baseline = 20% (5 classes). 4.56× better than random. ML ensemble\nwith weighted voting and probability calibration.\n\nThe engine itself remains proprietary; the ontology models the domain\nstructure it operates on.\n\n---\n\n## Note on East Asian Myeongli traditions\n\nThis MCP focuses on the Korean Myeongli (사주명리학) tradition, which\nshares its classical roots — 子平眞詮 (Zipingzhenquan), 滴天髓 (Diqianshui),\n窮通寶鑑 (Qiongtongbaojian), 淵海子平 (Yuanhaiziping), 三命通會 (Sanmingtonghui),\n欄江網 (Lanjiangwang) — with the Chinese Bazi (八字) tradition.\n\nRomanization uses Korean Revised Romanization (e.g., Yongshin, Sinsal).\nHanja (정자) is preserved throughout the ontology.\n\n본 MCP는 한국 명리학(사주명리학) 전통에 기반하며, 중국 八字 전통과\n6대 고전(자평진전·적천수·궁통보감·연해자평·삼명통회·난강망)을 공유합니다.\n\n---\n\n## Documentation\n\n- 📖 [Ontology specification](./ontology/) — formal OWL ontology with SPARQL examples\n\n---\n\n## Built by\n\n[Dangamsoft (단감소프트)](https://24plus.ai.kr) — Korean AI company\nspecializing in classical East Asian knowledge systems.\n\n🌐 https://24plus.ai.kr\n\n---\n\n## License\n\n- **Code** (live since v0.6.0): Apache 2.0\n- **Public OWL ontology** ([`ontology/`](./ontology/)): CC BY 4.0\n\nThe CAFE inference engine, scoring algorithms, ML model weights, and\ninterpretation templates remain proprietary.\n\n---\n\n> 더 깊은 분석(AI 선정 용신 · 전체 리포트)은 https://24plus.ai.kr\n",
  "bytes": 5276,
  "sha": "a920ff948e531f9d9b8cff9f631fb94af36ee00e670f8305df7b72a42f6d2da9",
  "repo_slug": "dangamsoft/cafe-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dangamsoft_cafe_mcp_a6570261/readme"
}