CAFE-MCP 1.0 · For Developers

CAFE 엔진을 내 AI에서

cafe-mcp는 24PLUS의 사주 엔진(CAFE)을 MCP(Model Context Protocol)로 공개한 무료 오픈소스입니다. AI가 사주를 짐작해서 말하지 않고, 엔진이 계산한 값을 받아서 답합니다. 같은 사주에는 늘 같은 결과가 나옵니다.

API 키, 가입, 설치가 필요 없습니다. 도구 6종 모두 무료입니다.

연결 1 · 주소로 연결 (추천)

커넥터 주소 하나면 됩니다

Claude(웹·데스크톱·모바일)에서는 설정의 커넥터 메뉴에서 「커스텀 커넥터 추가」를 누르고 아래 주소를 넣으면 됩니다. 원격 MCP를 지원하는 다른 AI 서비스도 같은 주소로 연결합니다.

URL

https://mcp.24plus.ai.kr/mcp

연결 2 · 내 PC에서 실행

npx 한 줄 (Claude Desktop, Cursor)

Claude Desktop은 설정의 Developer 메뉴에서 claude_desktop_config.json을 열어 아래 내용을 넣고 다시 시작합니다. Cursor는 ~/.cursor/mcp.json에 같은 내용을 넣습니다. Node.js 18 이상이 필요합니다.

json

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

무료 도구 6종

사주 도구 5종 공통 입력: birth(예: 1990-01-15T10:30, 필수) · sex(female 또는 male, 필수) · calendar(solar 또는 lunar) · rat_hour_rule(야자시 late, 조자시 early) · year_boundary(입춘 lichun, 동지 winter_solstice) · time_unknown. 만세력 달력은 month(2027-02) 또는 date(2027-02-04)만 받습니다. AI가 대화 내용에서 알아서 채우니 직접 입력할 일은 거의 없습니다.

saju_chart사주 원국

생년월일시로 사주 여덟 글자(천간·지지)와 십성, 지장간, 신살, 12운성을 계산합니다. 다른 분석의 출발점입니다.

ohaeng_balance오행 균형

목·화·토·금·수 다섯 기운의 분포를 지장간까지 반영해 수치로 보여 주고, 가장 강한 기운과 약한 기운을 짚습니다.

gyeokguk격국 분석

고전 규칙으로 사주의 격국(格局)과 등급, 신강·신약을 판정하고 판단 근거를 함께 줍니다.

eumyang_johu음양 조후

음양 비율과 조후(한난조습) 균형, 그리고 대운·세운에 따라 어떻게 달라지는지 보여 줍니다.

yongshin_candidates용신 후보

억부·병약·통관·조후·격국 다섯 방법이 각각 고르는 용신(用神) 후보를 보여 줍니다. 엔진이 최종 판별한 용신과 전체 풀이는 24PLUS 사주풀이에서 제공합니다.

manse_calendar만세력 달력

한 달 또는 하루의 일진, 월주·년주, 음력 날짜, 절기와 절입 시각, 손없는날·황도일을 줍니다. 생년월일 없이 날짜만 넣습니다.

사용 예시

이렇게 물어보세요

"1992년 7월 8일 오전 8시생 남자 사주 보여줘"
"나한테 부족한 오행이 뭐야?"
"내 격국이랑 용신 후보 알려줘"
"오늘 일진이 뭐야?"
"다음 달 손없는날 언제야?"

결과 형식

구조화된 데이터로 돌려줍니다

모든 도구는 JSON 데이터(structuredContent, 형식표 포함)와 짧은 요약을 함께 돌려줍니다. 오류는 invalid_input, rate_limited, timeout, backend_unavailable 네 가지 코드로 옵니다. 도구 이름과 입출력 형식은 1.0부터 고정되어, 바뀌면 버전 2.0으로 올립니다.

알아두기

입력한 생년월일은 계산에만 쓰고 저장하지 않습니다.
짧은 시간에 너무 많이 부르면 잠시 제한될 수 있습니다.
소스와 변경 기록은 GitHub에 공개돼 있습니다.
엔진이 최종 판별한 용신(91.1% 검증)과 대운 흐름·궁합·작명을 담은 전체 풀이는 24PLUS 사주풀이에서 볼 수 있습니다.

24+

로딩중...