@sazuapp/mcp-server 0.1.2 → 0.2.0

package/README.md

@@ -5,7 +5,30 @@ AI 에이전트 (Claude Code, Cursor, Windsurf, Codex, Antigravity 등) 가 사
 
 sazu.app 에서 제공하는 manse-api 이용자들을 위한 mcp-server 입니다.
 
-<br/><br/><br/><br/><br/><br/>
+<br/><br/><br/>
+
+## 왜 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 에이전트가 사주 데이터를 받아 콘텐츠 자동 생성 |
+| 인사·매칭·궁합 서비스 | 합형충파해 데이터로 관계 분석·매칭 알고리즘 |
+
+<br/><br/><br/>
 
 ## 설치
 
@@ -68,7 +91,7 @@ Antigravity 에디터 우상단 "…" → **Manage MCP Servers** → **View raw
 }
 ```
 
-<br/><br/><br/><br/><br/><br/>
+<br/><br/><br/>
 
 ## 시작하기
 
@@ -76,7 +99,7 @@ Antigravity 에디터 우상단 "…" → **Manage MCP Servers** → **View raw
 2. [Pro 구독](https://sazu.app/manse-api/pricing) — Free 사용자는 [docs 페이지](https://sazu.app/manse-api/docs) 의 curl 예시 활용
 3. [대시보드 → 키 발급](https://sazu.app/manse-api/dashboard/keys) — `SAZU_API_KEY` 환경변수에 설정
 
-<br/><br/><br/><br/><br/><br/>
+<br/><br/><br/>
 
 ## 노출 도구
 
@@ -85,7 +108,7 @@ Antigravity 에디터 우상단 "…" → **Manage MCP Servers** → **View raw
 | `sazu_calculate` | 사주팔자 + 14개 명리 분석 (오행·합형충파해·격국·용신·12운성·신살·허자·대운 등) |
 | `sazu_calendar_convert` | 양력 ↔ 음력 변환 (200년 만세력) |
 
-<br/><br/><br/><br/><br/><br/>
+<br/><br/><br/>
 
 ## 사용 예시
 
@@ -98,7 +121,7 @@ AI 에이전트에게 자연어로:
 
 → AI 가 `sazu_calculate` / `sazu_calendar_convert` 도구를 자동 호출.
 
-<br/><br/><br/><br/><br/><br/>
+<br/><br/><br/>
 
 ## 환경변수
 
@@ -107,14 +130,7 @@ AI 에이전트에게 자연어로:
 | `SAZU_API_KEY` | (필수) | Pro 플랜 API 키 |
 | `SAZU_API_BASE` | `https://api.sazu.app` | API 베이스 URL (커스텀 환경용) |
 
-<br/><br/><br/><br/><br/><br/>
-
-## 제한
-
-- 운세 텍스트 생성 기능은 노출하지 않습니다 (별도 라이선스 필요)
-- 인증·결제 엔드포인트는 노출하지 않습니다
-
-<br/><br/><br/><br/><br/><br/>
+<br/><br/><br/>
 
 ## 문의
 

package/dist/tools.d.ts

@@ -8,6 +8,10 @@
  * 공개:
  *   - sazu_calculate          : 사주팔자 + 14개 모듈 분석
  *   - sazu_calendar_convert   : 양력 ↔ 음력 변환
+ *
+ * 주의: MCP 입력은 AI 친화적 형태(birthDate 문자열·gender 등)지만 SAZU API 는
+ * birthYear/birthMonth/birthDay·isFemale·birthCity 를 받는다. 아래 실행 함수에서
+ * API 규격으로 매핑한다. (매핑 없으면 API 가 VALIDATION_ERROR 로 거부)
  */
 import { z } from 'zod';
 export declare const SazuCalculateInputSchema: z.ZodObject<{
@@ -23,6 +27,7 @@ export declare const SazuCalculateInputSchema: z.ZodObject<{
     }>>;
     isLeapMonth: z.ZodOptional<z.ZodBoolean>;
     location: z.ZodOptional<z.ZodString>;
+    trueSolarTime: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type SazuCalculateInput = z.infer<typeof SazuCalculateInputSchema>;
 export declare const CalendarConvertInputSchema: z.ZodObject<{
@@ -71,7 +76,11 @@ export declare const TOOL_DEFINITIONS: readonly [{
             };
             readonly location: {
                 readonly type: "string";
-                readonly description: "출생 도시 (선택, 진태양시 보정)";
+                readonly description: "출생 도시 (선택, 도시 경도 보정. 기본 서울)";
+            };
+            readonly trueSolarTime: {
+                readonly type: "boolean";
+                readonly description: "진태양시(경도차 + 균시차) 적용 여부 (선택, 기본 false). false = 한국 관습(자시 23:30). true = 한국천문연구원 방식 진태양시(자시 23:00, 균시차 포함).";
             };
         };
         readonly required: readonly ["birthDate", "gender"];

package/dist/tools.js

@@ -8,6 +8,10 @@
  * 공개:
  *   - sazu_calculate          : 사주팔자 + 14개 모듈 분석
  *   - sazu_calendar_convert   : 양력 ↔ 음력 변환
+ *
+ * 주의: MCP 입력은 AI 친화적 형태(birthDate 문자열·gender 등)지만 SAZU API 는
+ * birthYear/birthMonth/birthDay·isFemale·birthCity 를 받는다. 아래 실행 함수에서
+ * API 규격으로 매핑한다. (매핑 없으면 API 가 VALIDATION_ERROR 로 거부)
  */
 import { z } from 'zod';
 import { callApi } from './client.js';
@@ -24,6 +28,7 @@ export const SazuCalculateInputSchema = z.object({
     calendar: z.enum(['solar', 'lunar']).default('solar'),
     isLeapMonth: z.boolean().optional(),
     location: z.string().optional(),
+    trueSolarTime: z.boolean().optional(),
 });
 export const CalendarConvertInputSchema = z.object({
     date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'YYYY-MM-DD'),
@@ -31,19 +36,53 @@ export const CalendarConvertInputSchema = z.object({
     to: z.enum(['solar', 'lunar']),
     isLeapMonth: z.boolean().optional(),
 });
+// ── MCP 입력 → SAZU API 요청 매핑 ──
+/** "YYYY-MM-DD" → { year, month, day } */
+function splitDate(date) {
+    const [year, month, day] = date.split('-').map(Number);
+    return { year, month, day };
+}
+/** "HH:MM" → { hour, minute }. 미지정이면 hour=null. */
+function splitTime(time) {
+    if (!time)
+        return { hour: null, minute: 0 };
+    const [hour, minute] = time.split(':').map(Number);
+    return { hour, minute };
+}
 // ── 도구 실행 ──
 export async function executeSazuCalculate(input) {
     const parsed = SazuCalculateInputSchema.parse(input);
+    const { year, month, day } = splitDate(parsed.birthDate);
+    const { hour, minute } = splitTime(parsed.birthTime);
+    // MCP 입력 → SAZU API 규격
+    const apiBody = {
+        birthYear: year,
+        birthMonth: month,
+        birthDay: day,
+        birthHour: hour,
+        birthMinute: minute,
+        isFemale: parsed.gender === 'female',
+        isLunar: parsed.calendar === 'lunar',
+        birthCity: parsed.location ?? '서울',
+    };
+    if (parsed.trueSolarTime !== undefined)
+        apiBody.trueSolarTime = parsed.trueSolarTime;
     return callApi('/v1/sazu/calculate', {
         method: 'POST',
-        body: JSON.stringify(parsed),
+        body: JSON.stringify(apiBody),
     });
 }
 export async function executeCalendarConvert(input) {
     const parsed = CalendarConvertInputSchema.parse(input);
+    if (parsed.from === parsed.to) {
+        throw new Error('from 과 to 가 동일합니다. (solar↔lunar 변환만 지원)');
+    }
+    const { year, month, day } = splitDate(parsed.date);
+    // from/to → SAZU API direction (toSolar = 음력→양력, toLunar = 양력→음력)
+    const direction = parsed.to === 'solar' ? 'toSolar' : 'toLunar';
     return callApi('/v1/calendar/convert', {
         method: 'POST',
-        body: JSON.stringify(parsed),
+        body: JSON.stringify({ year, month, day, direction }),
     });
 }
 // ── 도구 메타데이터 (MCP server 등록용) ──
@@ -59,7 +98,11 @@ export const TOOL_DEFINITIONS = [
                 gender: { type: 'string', enum: ['male', 'female'], description: '성별' },
                 calendar: { type: 'string', enum: ['solar', 'lunar'], description: '양/음력 (기본 solar)', default: 'solar' },
                 isLeapMonth: { type: 'boolean', description: '윤달 여부 (lunar 일 때만)' },
-                location: { type: 'string', description: '출생 도시 (선택, 진태양시 보정)' },
+                location: { type: 'string', description: '출생 도시 (선택, 도시 경도 보정. 기본 서울)' },
+                trueSolarTime: {
+                    type: 'boolean',
+                    description: '진태양시(경도차 + 균시차) 적용 여부 (선택, 기본 false). false = 한국 관습(자시 23:30). true = 한국천문연구원 방식 진태양시(자시 23:00, 균시차 포함).',
+                },
             },
             required: ['birthDate', 'gender'],
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sazuapp/mcp-server",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "SAZU API MCP server — AI agents (Claude Code/Cursor/Windsurf) 가 사주·만세력 API 를 직접 호출.",
   "type": "module",
   "bin": {
@@ -14,7 +14,8 @@
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "start": "node dist/index.js",
-    "dev": "tsc -p tsconfig.json --watch"
+    "dev": "tsc -p tsconfig.json --watch",
+    "prepublishOnly": "tsc -p tsconfig.json"
   },
   "engines": {
     "node": ">=20"