aimakeall-mcp 0.8.0 → 0.9.0

package/README.md

@@ -16,7 +16,7 @@ Claude Code·Codex 같은 MCP 클라이언트에서 자연어로 AImakeAll 영
   "mcpServers": {
     "aimakeall": {
       "command": "npx",
-      "args": ["-y", "aimakeall-mcp@0.8.0"],
+      "args": ["-y", "aimakeall-mcp@0.9.0"],
       "env": { "AIMAKEALL_PAT": "aio_pat_..." }
     }
   }

package/lib/cloud-tools.mjs

@@ -23,16 +23,15 @@ import {
 import { mp3DurationSec } from "./mp3-duration.mjs";
 import { canonicalYoutubeWatchUrl } from "./payload-guard.mjs";
 import { createUsageEventId } from "./usage-event.mjs";
+import { loudnessDbfsFromWav, silenceRatioFromWav } from "./wav-dsp.mjs";
 import { trimWavToSeconds } from "./wav-trim.mjs";
 
 // 여러 파일을 base64 로 싣는 요청의 인코딩 크기 합이 서버 JSON 상한을 넘지 않게 사전 검사.
 // 서버가 전체 업로드를 받은 뒤 413 을 내는 것을 막고 행동 가능한 한국어 안내를 준다.
 const BODY_BUDGET_BYTES = SERVER_JSON_BODY_LIMIT_BYTES - 512 * 1024; // 바디의 나머지 필드 여유
 
-// 컴패니언 계약 상수 — companion/index.cjs 의 MAX_SHOT_COUNT 및 오디오 추출 포맷과 맞춘다.
-// 오디오는 extractCompanionAudio 기본값(16kHz)·16bit·모노 = 초당 32,000 바이트.
+// 컴패니언 계약 상수 — companion/index.cjs 의 MAX_SHOT_COUNT 와 맞춘다.
 const COMPANION_MAX_SHOTS = 18;
-const COMPANION_AUDIO_BYTES_PER_SECOND = 16_000 * 2;
 
 function assertEncodedBudget(filePaths, { context = "요청" } = {}) {
   let total = 0;
@@ -253,7 +252,7 @@ export function registerCloudTools(server, config, api) {
       categoryId: z.enum(["community-shorts", "viral-shorts", "insight"]).optional().describe("기본 community-shorts. insight=명언(통찰) 쇼츠"),
       targetCustomer: z.string().optional(),
       tone: z.string().optional().describe("기본 '자동 추천'"),
-      sceneCount: z.number().int().min(1).max(10).optional().describe("기본 3"),
+      sceneCount: z.number().int().min(1).max(10).optional().describe("씬 수. 생략하면 channelFingerprint 의 목표 길이로 자동 산출(지문도 없으면 3)"),
       channelFingerprint: z.object({
         sampleSize: z.number().optional(),
         durationTargetSec: z.number().nullable().optional(),
@@ -276,7 +275,7 @@ export function registerCloudTools(server, config, api) {
         forbidden: z.string().optional().describe("금지 변형 (기본: different face, different hairstyle)"),
       })).max(4).optional().describe("등장 캐릭터 — 서버가 씬마다 identity_lock 을 imagePrompt 에 강제 주입해 캐릭터 일관성을 잠급니다"),
     },
-    wrapCloudHandler(config, async ({ topic = "", copy = "", categoryId = "community-shorts", targetCustomer = "", tone = "자동 추천", sceneCount = 3, characters = [], channelFingerprint = null }) => {
+    wrapCloudHandler(config, async ({ topic = "", copy = "", categoryId = "community-shorts", targetCustomer = "", tone = "자동 추천", sceneCount = 0, characters = [], channelFingerprint = null }) => {
       if (!String(topic).trim() && !String(copy).trim()) {
         return textResult("topic 또는 copy 중 하나는 입력해야 합니다.", { isError: true });
       }
@@ -780,9 +779,14 @@ export function registerCloudTools(server, config, api) {
       emphasisKeywords: z.array(z.string()).max(12).optional().describe("강조 단어 목록 — 자막 라인 안에서 해당 단어만 다른 색/크기로 렌더 (plan_shorts_video의 emphasisKeywords 를 그대로 전달)"),
       emphasisColor: z.string().regex(/^#[0-9a-fA-F]{6}$/, "#RRGGBB 형식").optional().describe("강조 색 #RRGGBB (기본 #facc15 노랑)"),
       emphasisSizeScale: z.number().optional().describe("강조 크기 배율 0.5~2 (기본 1.2)"),
+      channelFingerprint: z.object({
+        subtitleYPct: z.number().nullable().optional(),
+        subtitleLines: z.number().nullable().optional(),
+        hasBgm: z.boolean().nullable().optional(),
+      }).passthrough().optional().describe("measure_channel_spec 이 반환한 fingerprint — 자막 세로 위치·BGM 유무를 참고 채널에 맞춥니다"),
       transitionMode: z.enum(["fade", "none"]).optional().describe("기본 fade"),
     },
-    wrapCloudHandler(config, async ({ sceneVideos, featureKey = "commerceVideo", projectTitle = "aimakeall-mcp", aspectRatio = "9:16", ttsAudioPath = "", bgmAudioPath = "", audioDurationSec = 0, bgmVolume = null, muteVideoAudio = true, titleText = "", subtitleLines = [], emphasisKeywords = [], emphasisColor = "", emphasisSizeScale = 0, transitionMode = "fade" }) => {
+    wrapCloudHandler(config, async ({ sceneVideos, featureKey = "commerceVideo", projectTitle = "aimakeall-mcp", aspectRatio = "9:16", ttsAudioPath = "", bgmAudioPath = "", audioDurationSec = 0, bgmVolume = null, muteVideoAudio = true, titleText = "", subtitleLines = [], emphasisKeywords = [], emphasisColor = "", emphasisSizeScale = 0, transitionMode = "fade", channelFingerprint = null }) => {
       // 오디오 확장자 검증 + 합산 크기 예산(서버 413 사전 차단).
       if (ttsAudioPath) assertAllowedInputFile(ttsAudioPath, new Set([".mp3", ".wav"]), { kind: "TTS 오디오" });
       if (bgmAudioPath) assertAllowedInputFile(bgmAudioPath, new Set([".mp3", ".wav"]), { kind: "BGM 오디오" });
@@ -807,6 +811,7 @@ export function registerCloudTools(server, config, api) {
         })),
         emphasisColor,
         emphasisKeywords,
+        channelFingerprint,
         emphasisSizeScale,
         subtitleLines,
         titleText,
@@ -944,6 +949,17 @@ export function registerCloudTools(server, config, api) {
       christianContentType: z.enum(["youtube-narration", "prayer", "devotional", "comfort-message"]).optional().describe("styleId=christian일 때 유형"),
       insightFigureNames: z.string().optional().describe("styleId=insight일 때 인물명(쉼표 구분)"),
       userOpinion: z.string().optional().describe("본문에 자연스럽게 녹일 작성자 의견"),
+      channelFingerprint: z.object({
+        durationTargetSec: z.number().nullable().optional(),
+        cutIntervalSec: z.number().nullable().optional(),
+        cpsTarget: z.number().nullable().optional(),
+        subtitleYPct: z.number().nullable().optional(),
+        subtitleLines: z.number().nullable().optional(),
+        endingStyle: z.string().nullable().optional(),
+        emphasisCount: z.number().nullable().optional(),
+        hasBgm: z.boolean().nullable().optional(),
+        sampleSize: z.number().optional(),
+      }).passthrough().optional().describe("measure_channel_spec 의 fingerprint — 실측 규격(길이·컷·말끝)을 대본에 강제합니다"),
     },
     wrapCloudHandler(config, async ({
       title,
@@ -957,12 +973,15 @@ export function registerCloudTools(server, config, api) {
       christianContentType = "youtube-narration",
       insightFigureNames = "",
       userOpinion = "",
+      channelFingerprint = null,
     }) => {
       const SCRIPT_MODEL_MAP = { gemini: "gemini-3.5-flash", opus: "claude-opus-4-8", sonnet: "claude-sonnet-5" };
       const payload = await api.request("/api/tracker/ai/script", {
         body: {
           apiModel: SCRIPT_MODEL_MAP[model] || SCRIPT_MODEL_MAP.gemini,
-          channelStyleProfile: null,
+          // 지문이 있으면 styleProfile 껍데기에 실어 보낸다 — 서버 script-prompts 가
+          // channelStyleProfile.fingerprint 에서 실측 규격 지시문을 뽑는다.
+          channelStyleProfile: channelFingerprint ? { fingerprint: channelFingerprint } : null,
           channelStyleReferenceText: "",
           christianContentType,
           contentFormat,
@@ -1445,13 +1464,11 @@ export function registerCloudTools(server, config, api) {
     wrapCloudHandler(config, async ({ videoUrls }) => {
       const specs = [];
       const notes = [];
-      // 서버 채널지문 라우트의 본문 상한은 16MB. 표본당 120초 WAV(16kHz·16bit 모노)는
-      // base64 ~5.1MB 라 표본 3개만 넘어도 합산이 상한을 넘겨 전체 413 으로 죽는다.
-      // 표본 수에 맞춰 오디오 트림 길이를 나눠 갖고, 누적 크기도 방어적으로 감시한다.
-      const audioBudgetChars = 9_000_000;
-      const base64CharsPerAudioSecond = Math.ceil(COMPANION_AUDIO_BYTES_PER_SECOND * 4 / 3);
-      const audioTrimSeconds = Math.max(20, Math.min(120, Math.floor(audioBudgetChars / videoUrls.length / base64CharsPerAudioSecond)));
-      let audioCharsUsed = 0;
+      // 라우드니스·무음은 여기서 재고 "숫자만" 보낸다. 오디오를 서버로 올리면 표본 3편만
+      // 넘어도 서버 본문 상한(16MB)을 넘겨 요청 전체가 죽고, 그걸 피하려 트림을 줄이면
+      // 표본이 많을수록 측정 구간이 짧아진다. 웹(src/lib/channelFingerprint.js)도 같은 이유로
+      // 브라우저에서 재고 숫자만 보낸다.
+      const audioTrimSeconds = 120;
       for (const [index, rawUrl] of videoUrls.entries()) {
         const watchUrl = canonicalYoutubeWatchUrl(rawUrl);
         if (!watchUrl) {
@@ -1485,25 +1502,24 @@ export function registerCloudTools(server, config, api) {
           if (cutCountClamped) {
             notes.push(`표본 ${index + 1}: 감지 컷이 컴패니언 상한(${COMPANION_MAX_SHOTS})에 도달 — 컷 수는 하한값이라 컷 리듬 축에서 제외`);
           }
-          // 오디오 — 라우드니스/무음은 서버가 검증된 DSP 로 실측.
-          let audioBase64 = "";
+          // 오디오 — 여기서 실측해 숫자만 싣는다(서버 DSP 와 동일 알고리즘, wav-dsp.mjs).
+          let loudnessDbfs = null;
+          let silenceRatio = null;
           try {
             const wav = await extractCompanionAudio(config.companionUrl, { url: watchUrl });
-            const encoded = trimWavToSeconds(wav, audioTrimSeconds).toString("base64");
-            if (audioCharsUsed + encoded.length > audioBudgetChars) {
-              notes.push(`표본 ${index + 1}: 본문 예산 초과로 오디오 제외 — 라우드니스 축 제외`);
-            } else {
-              audioBase64 = encoded;
-              audioCharsUsed += encoded.length;
-            }
+            const trimmed = trimWavToSeconds(wav, audioTrimSeconds);
+            loudnessDbfs = loudnessDbfsFromWav(trimmed);
+            silenceRatio = silenceRatioFromWav(trimmed);
+            if (loudnessDbfs === null) notes.push(`표본 ${index + 1}: WAV 파싱 실패 — 라우드니스 축 제외`);
           } catch (error) {
             notes.push(`표본 ${index + 1}: 오디오 추출 실패(${String(error?.message || error).slice(0, 80)}) — 라우드니스 축 제외`);
           }
           specs.push({
-            audioBase64,
             ...(cutCountClamped ? {} : { cutCount: shots.length }),
             durationSec,
             frames,
+            ...(loudnessDbfs !== null ? { loudnessDbfs } : {}),
+            ...(silenceRatio !== null ? { silenceRatio } : {}),
             videoId: watchUrl.slice(-11),
           });
         } catch (error) {

package/lib/config.mjs

@@ -2,7 +2,7 @@ import { homedir } from "node:os";
 import path from "node:path";
 
 // 프록시 버전 — 서버가 X-AImakeAll-MCP-Version 으로 하한을 강제(426)할 수 있다.
-export const MCP_PROXY_VERSION = "0.8.0";
+export const MCP_PROXY_VERSION = "0.9.0";
 
 export const DEFAULT_API_BASE = "https://aimakeall.com";
 export const DEFAULT_COMPANION_URL = "http://127.0.0.1:9876";

package/lib/wav-dsp.mjs

@@ -0,0 +1,82 @@
+// WAV 라우드니스·무음 실측 — server/channel-fingerprint.mjs 의 동일 알고리즘을 MCP 로 이식한 것.
+// 이식하는 이유: 지문 측정에서 오디오를 서버로 올리면 표본 3편만 넘어도 서버 본문 상한(16MB)을
+// 넘겨 요청 전체가 죽는다. 웹(src/lib/channelFingerprint.js)도 같은 이유로 브라우저에서 재고
+// 숫자만 보낸다. MCP 는 별도 npm 패키지라 server/ 를 import 할 수 없어 코드를 복제하되,
+// wav-dsp.test.mjs 가 서버 구현과의 수치 일치를 계약으로 고정한다.
+//
+// 세 구현(서버·웹·MCP)은 반드시 같은 숫자를 내야 한다. 한쪽을 고치면 나머지도 같이 고칠 것.
+
+export function parseWavPcm(buffer) {
+  if (!Buffer.isBuffer(buffer) || buffer.length < 44) return null;
+  if (buffer.toString("ascii", 0, 4) !== "RIFF" || buffer.toString("ascii", 8, 12) !== "WAVE") return null;
+  let offset = 12;
+  let fmt = null;
+  let dataOffset = -1;
+  let dataLen = 0;
+  while (offset + 8 <= buffer.length) {
+    const id = buffer.toString("ascii", offset, offset + 4);
+    const size = buffer.readUInt32LE(offset + 4);
+    const body = offset + 8;
+    // fmt 청크 헤더는 있으나 본문(16바이트)이 잘린 버퍼는 건너뛴다 — 읽기 범위 초과 대신 null.
+    if (id === "fmt " && body + 16 <= buffer.length) {
+      fmt = {
+        audioFormat: buffer.readUInt16LE(body),
+        channels: buffer.readUInt16LE(body + 2),
+        sampleRate: buffer.readUInt32LE(body + 4),
+        bitsPerSample: buffer.readUInt16LE(body + 14),
+      };
+    } else if (id === "data") {
+      dataOffset = body;
+      dataLen = Math.min(size, buffer.length - body);
+    }
+    offset = body + size + (size % 2); // chunks are word-aligned
+  }
+  if (!fmt || dataOffset < 0 || fmt.bitsPerSample !== 16 || fmt.audioFormat !== 1) return null;
+  return { ...fmt, dataOffset, dataLen };
+}
+
+// 16-bit PCM 표본을 순회하며 콜백. 첫 채널만 사용(모노 가정, 스테레오면 좌채널).
+function forEachSample(buffer, wav, fn) {
+  const step = 2 * Math.max(1, wav.channels);
+  for (let i = wav.dataOffset; i + 1 < wav.dataOffset + wav.dataLen; i += step) {
+    fn(buffer.readInt16LE(i) / 32768);
+  }
+}
+
+// RMS → dBFS. 무음(전부 0)이면 -Infinity 대신 -100 으로 바닥 처리.
+export function loudnessDbfsFromWav(buffer) {
+  const wav = parseWavPcm(buffer);
+  if (!wav) return null;
+  let sumSq = 0;
+  let n = 0;
+  forEachSample(buffer, wav, (s) => { sumSq += s * s; n += 1; });
+  if (!n) return null;
+  const rms = Math.sqrt(sumSq / n);
+  if (rms <= 0) return -100;
+  return Math.max(-100, Math.round(20 * Math.log10(rms) * 10) / 10);
+}
+
+// 무음 비율 — 짧은 창(20ms)의 RMS 가 임계(dBFS) 아래인 시간 비율. 0~1.
+export function silenceRatioFromWav(buffer, { thresholdDb = -45, windowMs = 20 } = {}) {
+  const wav = parseWavPcm(buffer);
+  if (!wav) return null;
+  const win = Math.max(1, Math.floor((wav.sampleRate * windowMs) / 1000));
+  const thresholdRms = Math.pow(10, thresholdDb / 20);
+  let windows = 0;
+  let silent = 0;
+  let sumSq = 0;
+  let count = 0;
+  forEachSample(buffer, wav, (s) => {
+    sumSq += s * s;
+    count += 1;
+    if (count >= win) {
+      const rms = Math.sqrt(sumSq / count);
+      windows += 1;
+      if (rms < thresholdRms) silent += 1;
+      sumSq = 0;
+      count = 0;
+    }
+  });
+  if (!windows) return null;
+  return Math.round((silent / windows) * 1000) / 1000;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aimakeall-mcp",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "AImakeAll MCP 서버 — Claude Code/Codex에서 자연어로 영상 기획·생성·렌더·퍼블리시 (렌더는 로컬 컴패니언)",
   "type": "module",
   "bin": {