@sazuapp/mcp-server 0.1.4 → 0.2.1

package/README.md

@@ -105,7 +105,7 @@ Antigravity 에디터 우상단 "…" → **Manage MCP Servers** → **View raw
 
 | 도구 | 설명 |
 |---|---|
-| `sazu_calculate` | 사주팔자 + 14개 명리 분석 (오행·합형충파해·격국·용신·12운성·신살·허자·대운 등) |
+| `sazu_calculate` | 사주팔자 + 14개 명리 분석 (오행·합형충파해·격국·용신·12운성·신살·허자·대운 등). `trueSolarTime` 로 진태양시 선택 가능 |
 | `sazu_calendar_convert` | 양력 ↔ 음력 변환 (200년 만세력) |
 
 <br/><br/><br/>
@@ -117,10 +117,20 @@ AI 에이전트에게 자연어로:
 ```
 "1985년 3월 15일 14시 출생 남자의 사주를 분석해줘"
 "1990년 음력 4월 8일을 양력으로 변환해줘"
+"1990년 11월 7일 23시 20분 서울 출생, 진태양시로 사주 분석해줘"
 ```
 
 → AI 가 `sazu_calculate` / `sazu_calendar_convert` 도구를 자동 호출.
 
+### 진태양시 옵션 (v0.2.0+ · API v1.1.0+)
+
+`sazu_calculate` 의 `trueSolarTime` 파라미터로 시각 보정을 선택합니다.
+
+- **기본(false)** — 한국 만세력 관습 (자시 23:30, 도시 경도차 보정)
+- **true** — 한국천문연구원 방식 진태양시 (자시 23:00, **경도차 + 균시차**)
+
+같은 생년월일·시각이라도 두 방식의 시주가 시(時) 경계 부근에서 달라질 수 있습니다. 문서: https://www.sazu.app/manse-api/docs#birth-city
+
 <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.4",
+  "version": "0.2.1",
   "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"