@decasoul/mcp-server

DecaSoul MCP server는 AI 어시스턴트(Claude, Cursor 및 모든 MCP 클라이언트)가 생년월일시로 중국 사주명리 차트 — Bazi(八字) — 를 계산하고, 그 사람의 십신(十神) 원형을 직접 읽을 수 있게 해주는 Model Context Protocol 서버입니다.

이것은 DecaSoul — 동양의 MBTI — 의 공식 MCP 통합입니다. 4,000년 역사의 중국 자기이해 시스템으로, 자기보고식 답변이 아닌 출생 시각의 사주(四柱)에서 성격과 인생 패턴을 읽습니다.

⚠️ 이 서버는 예측 엔진이 아닌 자기이해/성격 프레임워크입니다. 성찰과 교육을 위한 것이며, 의학적·심리적·재정적 조언이 아닙니다.

기능

AI 어시스턴트가 이 서버에 연결하면 analyze_bazi라는 단일 도구를 얻게 되며, 출생 시각을 읽을 수 있는 차트로 변환합니다:

• 사주(八字 / SiZhu): 연주, 월주, 일주, 시주 — 각각 천간(天干) + 지지(地支)로 구성됩니다.

• 일주(日主): 일간 — 전체 차트의 기준점입니다.

• 주요 십신(十神 / ShiShen): 차트의 주요 원형으로, 중국어와 영어 이름으로 매핑됩니다.

계산은 오픈소스 @decasoul/bazi-calculator 라이브러리에 위임되므로, 로직은 투명하고 검증 가능합니다.

Related MCP server: Chinese Fortune Analysis System (BaZi)

설치

npm install @decasoul/mcp-server

MCP 서버로 실행

npx decasoul-mcp

클라이언트 구성

MCP 클라이언트의 설정에 추가하세요. 예를 들어, Claude Desktop(claude_desktop_config.json)에서는:

{
  "mcpServers": {
    "decasoul-bazi": {
      "command": "npx",
      "args": ["-y", "@decasoul/mcp-server"]
    }
  }
}

Cursor 또는 다른 MCP 클라이언트의 경우 동일한 명령을 가리키면 서버가 자동으로 analyze_bazi 도구를 광고합니다.

도구 참조

analyze_bazi

출생 시각으로 사주와 주요 십신을 계산합니다.

사주 네 기둥, 일주, 주요 십신을 중국어와 영어로 포함한 텍스트 요약을 반환합니다.

십신(十神)이란?

십신은 Bazi 차트의 모든 다른 요소가 일주와 맺는 관계에서 파생된 열 가지 관계적 원형입니다. 이것이 "동양의 MBTI"의 엔진입니다:

Bazi와 중국 십이지의 차이

흔한 질문은 Bazi(八字) 가 중국 십이지(生肖) 와 같은 것인지입니다. 아닙니다:

십이지는 단 하나의 음표이고, Bazi는 전체 악보입니다 — 그래서 이 서버는 연도 띠만이 아닌 전체 사주를 계산합니다.

왜 4,000년인가?

이 시스템은 역경(易经)과 음양오행(五行) 이론에서 유래했습니다. 한나라 때 형태를 갖추었고, 이허중(唐代李虚中)과 서자평(宋代徐子平, 연해자평 渊海子平의 저자)에 의해 정련되었으며, 명·청 왕조를 거치며 번성하여 한때 황실과 귀족의 혼인 중매와 길일 선택에 사용되었습니다. 그 계보가 "동양의 MBTI"의 문화적 기반입니다.

라이선스

MIT — DecaSoul Research (Shenshuge Information Consulting). LICENSE 참조.