aimakeall-mcp 0.4.0 → 0.4.2

package/README.md

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

package/lib/cloud-tools.mjs

@@ -188,12 +188,12 @@ export function registerCloudTools(server, config, api) {
 
   server.tool(
     "research_product",
-    "상품 링크로 리뷰 기반 시장조사를 합니다: 구매자 불만 TOP3(근거 리뷰 인용)·첫 3초 후킹 패턴·경쟁 광고 공백·핵심 USP·금지 표현. 결과의 planBrief는 plan_commerce_video의 researchBrief로, productImagePaths는 productImagePaths로 그대로 이어가세요. 사이트가 서버 접근을 차단하면(fetchBlocked 안내) 에이전트가 직접 상품 페이지·리뷰를 읽어 pageText/reviewsText로 다시 호출하세요.",
+    "상품 링크로 리뷰 기반 시장조사를 합니다: 구매자 불만 TOP3(근거 리뷰 인용)·첫 3초 후킹 패턴·경쟁 광고 공백·핵심 USP·금지 표현. 결과의 planBrief는 plan_commerce_video의 researchBrief로, productImagePaths는 productImagePaths로 그대로 이어가세요. 사이트가 서버 접근을 차단하면(fetchBlocked 안내) 에이전트가 직접 페이지를 읽어 넘기되, 쿠팡처럼 에이전트 브라우저까지 막는 몰은 사용자에게 보이는 리뷰·설명을 복사해 달라고 요청해 reviewsText로 다시 호출하세요.",
     {
       productUrl: z.string().optional().describe("상품 페이지 URL (아마존·쇼핑몰 등)"),
       productName: z.string().optional().describe("상품명 (URL 없이 텍스트만 넘길 때)"),
       pageText: z.string().optional().describe("에이전트가 직접 읽은 상품 페이지 텍스트 (봇 차단 폴백)"),
-      reviewsText: z.string().optional().describe("에이전트가 수집한 구매 후기 텍스트 (봇 차단 폴백)"),
+      reviewsText: z.string().optional().describe("구매 후기 텍스트 — 에이전트 수집분 또는 사용자가 복사해 준 리뷰 (봇 차단 폴백)"),
       downloadImages: z.boolean().optional().describe("기본 true — 상품 이미지를 로컬 저장해 plan_commerce_video용 경로 반환"),
     },
     wrapCloudHandler(config, async ({ productUrl = "", productName = "", pageText = "", reviewsText = "", downloadImages = true }) => {
@@ -314,7 +314,7 @@ export function registerCloudTools(server, config, api) {
 
   server.tool(
     "generate_scene_image",
-    "씬 이미지를 생성합니다 (기획 결과의 imagePrompt 사용). 반환된 imageUrl을 씬 영상 생성의 입력으로 쓰세요. 캐릭터/앞씬 일관성이 필요하면 앞 씬의 imageUrl을 referenceImageUrls로 전달하세요.",
+    "씬 이미지를 생성합니다 (기획 결과의 imagePrompt 사용). 반환된 imageUrl을 씬 영상 생성의 입력으로 쓰세요. 인물·제품 일관성은 이 참조 방식이 권장 경로입니다: 첫 씬(또는 캐릭터 시트/제품 사진)의 이미지를 referenceImageUrls·referenceImagePaths로 모든 씬에 앵커로 전달하세요.",
     {
       prompt: z.string().describe("이미지 프롬프트 (plan 결과의 imagePrompt)"),
       aspectRatio: z.string().optional().describe("기본 9:16"),
@@ -1101,196 +1101,6 @@ export function registerCloudTools(server, config, api) {
     }),
   );
 
-  // ── 인플루언서(소울) 스튜디오 ────────────────────────────────────────────────
-  server.tool(
-    "create_influencer_character",
-    "참조 사진으로 인플루언서(소울) 캐릭터를 학습 등록합니다. 학습 비용 $2.50(1회성) — 실패 시 자동 재시도 금지(중복 과금). 등록 후 influencer_character_status로 completed까지 10초 간격 폴링하세요 (수 분 소요).",
-    {
-      name: z.string().min(1).describe("캐릭터 이름"),
-      photoPaths: z.array(z.string()).min(5).max(18).describe("동일 인물 사진 로컬 경로 5~18장 (jpg/png/webp)"),
-    },
-    wrapCloudHandler(config, async ({ name, photoPaths }) => {
-      for (const filePath of photoPaths) assertAllowedInputFile(filePath, ALLOWED_IMAGE_EXTS, { kind: "참조 사진" });
-      const publicUrls = [];
-      // 업로드 URL 발급은 사진 수만큼 쓰기 슬롯(20/분)을 쓰므로, 분당 한도에 걸리면
-      // retryAfterSeconds 만큼 대기 후 이어서 진행한다(발급된 URL 은 보존).
-      const issueUploadUrl = async (mime) => {
-        for (let attempt = 0; ; attempt += 1) {
-          try {
-            return await api.request("/api/tracker/higgsfield/files/generate-upload-url", {
-              body: { content_type: mime },
-              method: "POST",
-              timeoutMs: 30_000,
-            });
-          } catch (error) {
-            if (error instanceof AimakeallApiError && error.errorCode === "MACHINE_RATE_LIMITED" && attempt < 3) {
-              await new Promise((resolve) => setTimeout(resolve, Math.max(1, error.retryAfterSeconds || 10) * 1000));
-              continue;
-            }
-            throw error;
-          }
-        }
-      };
-      // presigned PUT(직접) — 컴패니언 불필요.
-      for (const filePath of photoPaths) {
-        const mime = guessMimeType(filePath, "image/jpeg");
-        const issued = await issueUploadUrl(mime);
-        const uploadUrl = String(issued?.upload_url || "");
-        const publicUrl = String(issued?.public_url || "");
-        if (!uploadUrl || !publicUrl) {
-          return textResult("업로드 URL 발급에 실패했습니다. Higgsfield API 키 연결을 확인하세요.", { isError: true });
-        }
-        const put = await fetch(uploadUrl, {
-          body: readFileSync(filePath),
-          headers: { "Content-Type": mime },
-          method: "PUT",
-          signal: AbortSignal.timeout(120_000),
-        });
-        if (!put.ok) {
-          return textResult(`사진 업로드 실패 (HTTP ${put.status}): ${path.basename(filePath)}`, { isError: true });
-        }
-        publicUrls.push(publicUrl);
-      }
-      let payload;
-      try {
-        // 서버의 업스트림 창(90s)보다 길게 잡아, 클라이언트가 먼저 끊어 "성공했는데
-        // 실패로 오인 → 재시도 → 중복 과금($2.50)" 되는 상황을 방지한다.
-        payload = await api.request("/api/tracker/higgsfield/v1/custom-references", {
-          body: { input_images: publicUrls.map((url) => ({ image_url: url, type: "image_url" })), name },
-          method: "POST",
-          timeoutMs: 120_000,
-        });
-      } catch (error) {
-        const reason = String(error?.message || error);
-        return textResult(
-          `캐릭터 학습 등록 요청이 실패했습니다: ${reason}\n재시도 전에 반드시 list_influencer_characters로 캐릭터가 이미 생성됐는지 확인하세요 — 생성돼 있다면 재시도는 중복 과금($2.50)입니다.`,
-          { isError: true },
-        );
-      }
-      const referenceId = String(payload?.id || payload?.reference_id || "");
-      if (!referenceId) return textResult("캐릭터 학습 등록 응답에 ID가 없습니다. list_influencer_characters로 생성 여부를 확인하세요.", { isError: true });
-      return jsonResult({
-        costUsd: payload?.costUsd,
-        next: "influencer_character_status를 10초 간격으로 폴링해 completed를 기다리세요. 이 호출을 재시도하면 중복 과금됩니다.",
-        photoCount: publicUrls.length,
-        referenceId,
-        status: payload?.status,
-      });
-    }),
-  );
-
-  server.tool(
-    "influencer_character_status",
-    "소울 캐릭터 학습 상태를 조회합니다 (terminal: completed | failed).",
-    { referenceId: z.string().min(1) },
-    wrapCloudHandler(config, async ({ referenceId }) => {
-      const payload = await api.request(`/api/tracker/higgsfield/v1/custom-references/${encodeURIComponent(referenceId)}`, {
-        method: "GET",
-        timeoutMs: 30_000,
-      });
-      return jsonResult({
-        name: payload?.name,
-        referenceId,
-        status: payload?.status,
-        thumbnailUrl: payload?.thumbnail_url,
-      });
-    }),
-  );
-
-  server.tool(
-    "list_influencer_characters",
-    "등록된 소울 캐릭터 목록을 조회합니다. (machine 토큰은 서버 경유로 만든 캐릭터만 상세 조회·생성에 사용 가능)",
-    { page: z.number().int().min(1).optional().describe("기본 1") },
-    wrapCloudHandler(config, async ({ page = 1 }) => {
-      const payload = await api.request(`/api/tracker/higgsfield/v1/custom-references/list?page=${page}&page_size=50`, {
-        method: "GET",
-        timeoutMs: 30_000,
-      });
-      return jsonResult({
-        characters: (Array.isArray(payload?.items) ? payload.items : []).map((item) => ({
-          id: item?.id,
-          name: item?.name,
-          status: item?.status,
-        })),
-        page,
-        totalPages: payload?.total_pages,
-      });
-    }),
-  );
-
-  server.tool(
-    "suggest_influencer_prompts",
-    "소울 이미지용 연출·프롬프트 10종을 추천받습니다. 반환 prompt는 부정규칙까지 완성형이므로 generate_influencer_image에 그대로 쓰세요.",
-    {
-      gender: z.enum(["여자", "남자"]),
-      ageRange: z.enum(["10대", "20대", "30대", "40대", "50대", "60대"]),
-      keyword: z.string().min(1).describe("장면 키워드 (예: 카페에서 책 읽는 모습)"),
-    },
-    wrapCloudHandler(config, async ({ gender, ageRange, keyword }) => {
-      const { events } = await api.requestSse("/api/tracker/gemini/soul-prompts", {
-        body: { ageRange, gender, imageModel: "soul", keyword },
-        timeoutMs: 180_000,
-      });
-      const items = events
-        .filter((event) => event?.type === "item" && event.item)
-        .map((event) => ({ directing: event.item.directing, id: event.item.id, prompt: event.item.prompt }));
-      if (!items.length) return textResult("프롬프트 추천 결과가 비어 있습니다.", { isError: true });
-      return jsonResult({ count: items.length, items });
-    }),
-  );
-
-  server.tool(
-    "generate_influencer_image",
-    "학습 완료(completed)된 소울 캐릭터로 인플루언서 이미지를 생성합니다 (720p $0.094/장, 1080p $0.19/장). 반환 requestId를 influencer_image_status로 폴링하세요 (~30초).",
-    {
-      prompt: z.string().min(1).describe("영문 프롬프트 (suggest_influencer_prompts 결과 그대로 권장)"),
-      referenceId: z.string().min(1).describe("completed 상태의 캐릭터 referenceId"),
-      aspectRatio: z.enum(["9:16", "16:9", "4:3", "3:4", "1:1", "2:3", "3:2"]).optional().describe("기본 4:3"),
-      resolution: z.enum(["720p", "1080p"]).optional().describe("기본 720p"),
-      imageReferenceUrl: z.string().optional().describe("구도/씬 참조 이미지 URL (선택)"),
-      seed: z.number().int().optional().describe("재현용 시드 (선택)"),
-    },
-    wrapCloudHandler(config, async ({ prompt, referenceId, aspectRatio = "4:3", resolution = "720p", imageReferenceUrl = "", seed }) => {
-      const payload = await api.request("/api/tracker/higgsfield/higgsfield-ai/soul/character", {
-        body: {
-          aspect_ratio: aspectRatio,
-          batch_size: 1,
-          custom_reference_id: referenceId,
-          custom_reference_strength: 1,
-          enhance_prompt: false,
-          ...(imageReferenceUrl ? { image_reference_url: imageReferenceUrl } : {}),
-          prompt,
-          resolution,
-          ...(seed !== undefined ? { seed } : {}),
-        },
-        method: "POST",
-        timeoutMs: 60_000,
-      });
-      const requestId = String(payload?.request_id || payload?.id || "");
-      if (!requestId) return textResult("이미지 생성 요청 응답에 request_id가 없습니다.", { isError: true });
-      return jsonResult({ costUsd: payload?.costUsd, requestId, status: payload?.status });
-    }),
-  );
-
-  server.tool(
-    "influencer_image_status",
-    "소울 이미지 생성 상태를 조회합니다 (terminal: completed | failed | nsfw | canceled). 결과 이미지는 만료 없는 공개 URL입니다.",
-    { requestId: z.string().min(1) },
-    wrapCloudHandler(config, async ({ requestId }) => {
-      const payload = await api.request(`/api/tracker/higgsfield/requests/${encodeURIComponent(requestId)}/status`, {
-        method: "GET",
-        timeoutMs: 30_000,
-      });
-      return jsonResult({
-        error: payload?.error || payload?.message || undefined,
-        imageUrls: (Array.isArray(payload?.images) ? payload.images : []).map((image) => image?.url).filter(Boolean),
-        progress: payload?.progress,
-        requestId,
-        status: payload?.status,
-      });
-    }),
-  );
-
   // ── 상세페이지(PDP) ─────────────────────────────────────────────────────────
   server.tool(
     "generate_pdp",

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.4.0";
+export const MCP_PROXY_VERSION = "0.4.2";
 
 export const DEFAULT_API_BASE = "https://aimakeall.com";
 export const DEFAULT_COMPANION_URL = "http://127.0.0.1:9876";

package/package.json

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