@sazuapp/mcp-server

SAZU API 의 MCP (Model Context Protocol) 서버. AI 에이전트 (Claude Code, Cursor, Windsurf, Codex, Antigravity 등) 가 사주·만세력 API 를 직접 호출합니다.

sazu.app 에서 제공하는 manse-api 이용자들을 위한 mcp-server 입니다.

왜 SAZU MCP 인가

사주·만세력·운세 관련 서비스를 만들고 있다면, 직접 명리 엔진을 구현하지 마세요.

• 🚀 연동 1줄, 5분이면 끝 — AI 에이전트에게 자연어로 말하면 사주 분석이 즉시 응답. fetch 코드·타입 정의·schema 검증 모두 불필요.
• 🎯 14개 명리 모듈 한 번에 — 사주팔자·합형충파해·격국·용신·12운성·신살·허자·대운까지 1회 호출로 완성. 자체 구현 시 수개월 작업.
• 📅 200년 범위 만세력 — 1900~2100 음/양력 변환, 절기 기반 월주 판별, 진태양시 보정. 명리학에 정확한 데이터 기반.
• ⚡ 50ms 이하 응답 — 챗봇·RAG·운세 앱·웹사이트에 즉시 통합. 사용자 경험 손실 0.
• 🧙 50년 임상 노하우 — 사주 전문가 감수, 다수의 임상 실험으로 검증된 분석 모듈.
• 🤖 AI 친화 설계 — Claude / GPT / Gemini 가 자연어를 구조화된 명리 데이터로 즉시 변환.

이런 분에게 추천

| 구축 중인 서비스 | 활용 | |---|---| | 운세 챗봇 / 사주 상담 봇 | sazu_calculate 로 즉시 사주 데이터 확보 → LLM 으로 자연어 풀이 | | 만세력 모바일 앱 | sazu_calendar_convert 로 음/양력 정확 변환 + 사주 원국 표시 | | 사주 SaaS / 명리 도구 | 14개 분석 모듈 그대로 활용, 자체 명리 알고리즘 R&D 비용 절감 | | 점술·역학 콘텐츠 자동화 | AI 에이전트가 사주 데이터를 받아 콘텐츠 자동 생성 | | 인사·매칭·궁합 서비스 | 합형충파해 데이터로 관계 분석·매칭 알고리즘 |

설치

Claude Code

claude mcp add sazu --env SAZU_API_KEY=sazu_pro_xxx -- npx -y @sazuapp/mcp-server

Cursor / Windsurf

~/.cursor/mcp.json 또는 .windsurf/mcp.json:

{
  "mcpServers": {
    "sazu": {
      "command": "npx",
      "args": ["-y", "@sazuapp/mcp-server"],
      "env": {
        "SAZU_API_KEY": "sazu_pro_xxx"
      }
    }
  }
}

OpenAI Codex CLI

CLI 한 줄:

codex mcp add sazu --env SAZU_API_KEY=sazu_pro_xxx -- npx -y @sazuapp/mcp-server

또는 ~/.codex/config.toml 에 직접 추가:

[mcp_servers.sazu]
command = "npx"
args = ["-y", "@sazuapp/mcp-server"]
env = { SAZU_API_KEY = "sazu_pro_xxx" }

Google Antigravity

Antigravity 에디터 우상단 "…" → Manage MCP Servers → View raw config → mcp_config.json 편집:

{
  "mcpServers": {
    "sazu": {
      "command": "npx",
      "args": ["-y", "@sazuapp/mcp-server"],
      "env": {
        "SAZU_API_KEY": "sazu_pro_xxx"
      }
    }
  }
}

시작하기

1. https://sazu.app/manse-api — 서비스 소개·가격 확인
2. Pro 구독 — Free 사용자는 docs 페이지 의 curl 예시 활용
3. 대시보드 → 키 발급 — SAZU_API_KEY 환경변수에 설정

노출 도구

| 도구 | 설명 | |---|---| | sazu_calculate | 사주팔자 + 14개 명리 분석 (오행·합형충파해·격국·용신·12운성·신살·허자·대운 등) | | sazu_calendar_convert | 양력 ↔ 음력 변환 (200년 만세력) |

사용 예시

AI 에이전트에게 자연어로:

"1985년 3월 15일 14시 출생 남자의 사주를 분석해줘"
"1990년 음력 4월 8일을 양력으로 변환해줘"

→ AI 가 sazu_calculate / sazu_calendar_convert 도구를 자동 호출.

환경변수

| 변수 | 기본값 | 설명 | |---|---|---| | SAZU_API_KEY | (필수) | Pro 플랜 API 키 | | SAZU_API_BASE | https://api.sazu.app | API 베이스 URL (커스텀 환경용) |

문의

[email protected]