@yoonion/mimi-seed-mcp 0.2.0 → 0.3.0

package/dist/index.js

@@ -2,12 +2,18 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { getAuthenticatedClient, getStoredTokens } from './auth/google-auth.js';
+import { getAuthenticatedClient, getStoredTokens, startAuth } from './auth/google-auth.js';
+import { MIMI_SEED_CLIENT_ID, MIMI_SEED_CLIENT_SECRET } from './auth/constants.js';
 import * as firebase from './firebase/tools.js';
 import * as admob from './admob/tools.js';
 import * as playstore from './playstore/tools.js';
 import * as appstore from './appstore/tools.js';
+import * as appstoreScreenshots from './appstore/screenshots.js';
 import * as iam from './iam/tools.js';
+import { checkPlayStoreRisks, checkAppStoreRisks, formatRisks } from './checks/risks.js';
+import { validateAppStoreScreenshots, validatePlayStoreScreenshots, formatValidationResults } from './checks/screenshots.js';
+import { generateReleaseNotesFromCommits, formatGeneratedNotes } from './ai/notes.js';
+import { generateReviewReply, formatReviewReply } from './ai/review.js';
 const server = new McpServer({
     name: 'mimi-seed',
     version: '0.1.0',
@@ -282,6 +288,65 @@ server.tool('playstore_list_tracks', 'Google Play 릴리스 트랙 현황 (프
     const tracks = await playstore.listTracks(auth, packageName);
     return { content: [{ type: 'text', text: JSON.stringify(tracks, null, 2) }] };
 });
+server.tool('playstore_list_images', 'Google Play 리스팅 이미지 목록 조회 (imageType별)', {
+    packageName: z.string().describe('패키지명'),
+    language: z.string().describe('언어 코드 (예: ko-KR)'),
+    imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']).describe('이미지 타입'),
+}, async ({ packageName, language, imageType }) => {
+    const auth = requireAuth();
+    const images = await playstore.listImages(auth, packageName, language, imageType);
+    return { content: [{ type: 'text', text: JSON.stringify(images, null, 2) }] };
+});
+server.tool('playstore_upload_image', 'Google Play 리스팅 이미지 단일 업로드 (기존 이미지 유지). featureGraphic 1024x500 / icon 512x512 / phoneScreenshots 320~3840px', {
+    packageName: z.string().describe('패키지명'),
+    language: z.string().describe('언어 코드'),
+    imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),
+    filePath: z.string().describe('업로드할 이미지 절대 경로'),
+}, async ({ packageName, language, imageType, filePath }) => {
+    const auth = requireAuth();
+    const result = await playstore.uploadImage(auth, packageName, language, imageType, filePath);
+    return { content: [{ type: 'text', text: `✅ 업로드 완료\n${JSON.stringify(result, null, 2)}` }] };
+});
+server.tool('playstore_delete_all_images', 'Google Play 리스팅 특정 imageType의 이미지 전체 삭제 (교체 전 정리)', {
+    packageName: z.string().describe('패키지명'),
+    language: z.string().describe('언어 코드'),
+    imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),
+}, async ({ packageName, language, imageType }) => {
+    const auth = requireAuth();
+    const result = await playstore.deleteAllImages(auth, packageName, language, imageType);
+    return { content: [{ type: 'text', text: `✅ 전체 삭제\n${JSON.stringify(result, null, 2)}` }] };
+});
+server.tool('playstore_replace_images', 'Google Play 리스팅 이미지 일괄 교체 (한 edit 세션: deleteall → 순서대로 upload → commit). 스크린샷 5~8장 한 번에 교체 시 효율적. 업로드 순서가 스토어 노출 순서', {
+    packageName: z.string().describe('패키지명'),
+    language: z.string().describe('언어 코드'),
+    imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),
+    filePaths: z.array(z.string()).describe('업로드할 이미지 절대 경로 배열 (순서 = 노출 순서)'),
+}, async ({ packageName, language, imageType, filePaths }) => {
+    const auth = requireAuth();
+    const result = await playstore.replaceImages(auth, packageName, language, imageType, filePaths);
+    return { content: [{ type: 'text', text: `✅ ${result.count}장 교체 완료\n${JSON.stringify(result, null, 2)}` }] };
+});
+server.tool('playstore_update_release_notes', "Google Play 트랙 릴리스의 '최근 변경사항'(releaseNotes) 업데이트. versionCode로 타겟 릴리스 지정. 다른 언어/release는 보존. 이미 라이브(completed) 상태도 noteOnly 편집 가능", {
+    packageName: z.string().describe('패키지명 (예: gg.pryzm.coffee)'),
+    track: z.enum(['production', 'beta', 'alpha', 'internal']).describe('릴리스 트랙'),
+    versionCode: z.string().describe('대상 versionCode (문자열, 예: "40")'),
+    language: z.string().describe('언어 코드 (예: ko-KR, en-US)'),
+    text: z.string().describe('릴리스 노트 본문 (500자 이내)'),
+}, async ({ packageName, track, versionCode, language, text }) => {
+    const auth = requireAuth();
+    const result = await playstore.updateReleaseNotes(auth, packageName, track, versionCode, language, text);
+    return { content: [{ type: 'text', text: `✅ ${packageName} ${track} v${versionCode} ${language} 노트 반영\n\n${JSON.stringify(result, null, 2)}` }] };
+});
+server.tool('playstore_update_latest_release_notes', "Google Play 트랙의 최신 릴리스(versionCode 최대) '최근 변경사항' 업데이트 — versionCode를 모를 때 편의용", {
+    packageName: z.string().describe('패키지명'),
+    track: z.enum(['production', 'beta', 'alpha', 'internal']).describe('릴리스 트랙'),
+    language: z.string().describe('언어 코드 (예: ko-KR)'),
+    text: z.string().describe('릴리스 노트 본문 (500자 이내)'),
+}, async ({ packageName, track, language, text }) => {
+    const auth = requireAuth();
+    const result = await playstore.updateLatestReleaseNotes(auth, packageName, track, language, text);
+    return { content: [{ type: 'text', text: `✅ ${packageName} ${track} (versionCodes=${JSON.stringify(result.updatedVersionCodes)}) ${language} 노트 반영\n\n${JSON.stringify(result, null, 2)}` }] };
+});
 server.tool('playstore_list_reviews', 'Google Play 리뷰 목록 조회', { packageName: z.string().describe('패키지명') }, async ({ packageName }) => {
     const auth = requireAuth();
     const reviews = await playstore.listReviews(auth, packageName);
@@ -500,6 +565,64 @@ server.tool('appstore_get_metadata', 'App Store 버전 메타데이터 (설명
     const localizations = await appstore.getVersionLocalizations(versionId);
     return { content: [{ type: 'text', text: JSON.stringify(localizations, null, 2) }] };
 });
+server.tool('appstore_update_localization', "App Store 버전 로컬라이제이션(메타데이터) 수정 — localizationId 직접 지정. 이 버전의 새로운 기능(whatsNew), 설명(description), 키워드, 프로모션 텍스트를 편집. 수정 가능한 상태(PREPARE_FOR_SUBMISSION 등)인 버전에서만 반영됨", {
+    localizationId: z.string().describe('로컬라이제이션 ID (appstore_get_metadata 결과의 id)'),
+    whatsNew: z.string().optional().describe('이 버전의 새로운 기능 (4000자 이내)'),
+    description: z.string().optional().describe('앱 설명 (4000자 이내)'),
+    keywords: z.string().optional().describe('키워드 (쉼표 구분, 100자 이내)'),
+    promotionalText: z.string().optional().describe('프로모션 텍스트 (170자 이내)'),
+    supportUrl: z.string().url().optional().describe('지원 URL'),
+    marketingUrl: z.string().url().optional().describe('마케팅 URL'),
+}, async ({ localizationId, ...fields }) => {
+    const cleaned = Object.fromEntries(Object.entries(fields).filter(([, v]) => v !== undefined));
+    if (Object.keys(cleaned).length === 0) {
+        throw new Error('수정할 필드를 하나 이상 지정해줘 (whatsNew, description, keywords, promotionalText, supportUrl, marketingUrl).');
+    }
+    const result = await appstore.updateVersionLocalization(localizationId, cleaned);
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+});
+server.tool('appstore_list_screenshots', "App Store 스크린샷 셋 + 이미지 목록 조회 (로컬라이제이션 단위). 디스플레이 타입별로 그룹핑됨", { localizationId: z.string().describe('로컬라이제이션 ID (appstore_get_metadata 결과의 id)') }, async ({ localizationId }) => {
+    const sets = await appstoreScreenshots.listScreenshotSets(localizationId);
+    return { content: [{ type: 'text', text: JSON.stringify(sets, null, 2) }] };
+});
+server.tool('appstore_upload_screenshot', [
+    "App Store 스크린샷 업로드 (자동 4단계: 셋 확보 → 예약 → 청크 업로드 → 커밋).",
+    "파일 경로는 로컬 절대경로. displayType은 Apple 공식 enum:",
+    "APP_IPHONE_69 (6.9\", 1290x2796) / APP_IPHONE_67 (6.7\", 1290x2796) /",
+    "APP_IPHONE_65 (6.5\", 1242x2688) / APP_IPHONE_61 (6.1\", 1170x2532) /",
+    "APP_IPHONE_58 (5.8\") / APP_IPHONE_55 (5.5\", 1242x2208) /",
+    "APP_IPAD_PRO_3GEN_129 (13\", 2064x2752) / APP_IPAD_PRO_3GEN_11 (11\", 1668x2388) /",
+    "APP_IPAD_PRO_129 (12.9\", 2048x2732) / APP_DESKTOP (2560x1600+).",
+    "해상도 틀리면 검수에서 리젝됨. 수정 가능한 버전 상태에서만 반영됨.",
+].join(' '), {
+    localizationId: z.string().describe('로컬라이제이션 ID'),
+    displayType: z.string().describe('Apple 스크린샷 디스플레이 타입 (예: APP_IPHONE_69)'),
+    filePath: z.string().describe('업로드할 이미지 파일의 절대경로'),
+}, async ({ localizationId, displayType, filePath }) => {
+    const result = await appstoreScreenshots.uploadScreenshot(localizationId, displayType, filePath);
+    return {
+        content: [{
+                type: 'text',
+                text: `✅ 스크린샷 업로드 완료 (${displayType})\n\n${JSON.stringify(result, null, 2)}`,
+            }],
+    };
+});
+server.tool('appstore_delete_screenshot', 'App Store 개별 스크린샷 삭제', { screenshotId: z.string().describe('스크린샷 ID (appstore_list_screenshots 결과)') }, async ({ screenshotId }) => {
+    const result = await appstoreScreenshots.deleteScreenshot(screenshotId);
+    return { content: [{ type: 'text', text: `✅ 스크린샷 삭제됨\n${JSON.stringify(result, null, 2)}` }] };
+});
+server.tool('appstore_delete_screenshot_set', 'App Store 스크린샷 셋 전체 삭제 (디스플레이 타입 교체 시 먼저 정리)', { setId: z.string().describe('스크린샷 셋 ID (appstore_list_screenshots 결과)') }, async ({ setId }) => {
+    const result = await appstoreScreenshots.deleteScreenshotSet(setId);
+    return { content: [{ type: 'text', text: `✅ 셋 삭제됨\n${JSON.stringify(result, null, 2)}` }] };
+});
+server.tool('appstore_update_whats_new', "App Store '이 버전의 새로운 기능' 편집 — versionId + locale만 주면 자동으로 로컬라이제이션을 찾아 PATCH. 가장 흔한 사용 케이스. 수정 가능한 상태(PREPARE_FOR_SUBMISSION 등)인 버전에서만 반영됨", {
+    versionId: z.string().describe('버전 ID (appstore_list_versions 결과)'),
+    locale: z.string().describe('로캘 (예: ko, en-US, ja)'),
+    whatsNew: z.string().describe("'이 버전의 새로운 기능' 텍스트 (4000자 이내)"),
+}, async ({ versionId, locale, whatsNew }) => {
+    const result = await appstore.updateVersionWhatsNew(versionId, locale, { whatsNew });
+    return { content: [{ type: 'text', text: `✅ ${locale} 로캘의 What's New가 업데이트됐어.\n\n${JSON.stringify(result, null, 2)}` }] };
+});
 server.tool('appstore_list_builds', 'TestFlight 빌드 목록', { appId: z.string().describe('앱 ID') }, async ({ appId }) => {
     const builds = await appstore.listBuilds(appId);
     return { content: [{ type: 'text', text: JSON.stringify(builds, null, 2) }] };
@@ -513,6 +636,30 @@ server.tool('appstore_get_app_info', 'App Store 앱 정보 (카테고리, 연령
     return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] };
 });
 // --- 인증 상태 ---
+server.tool('mimi_seed_auth_start', [
+    'Google OAuth 로그인 링크를 발급하고 백그라운드 콜백 서버를 시작.',
+    '응답에 포함된 URL을 브라우저에서 열고 승인하면 localhost:9876으로 자동 콜백 → 토큰이 ~/.mimi-seed/tokens.json에 저장됨.',
+    '이후 playstore_*, firebase_*, admob_* 등 다른 MCP 도구 바로 호출 가능.',
+    '토큰 만료(invalid_rapt) / 재인증 필요 시 사용. 10분 내 완료해야 함.',
+].join(' '), {}, async () => {
+    const { url, wait } = startAuth(MIMI_SEED_CLIENT_ID, MIMI_SEED_CLIENT_SECRET);
+    // fire-and-forget — 토큰은 콜백 서버가 자동 저장
+    wait.then(() => { }, (err) => { console.error('[mimi-seed auth]', err.message); });
+    return {
+        content: [{
+                type: 'text',
+                text: [
+                    '🔐 Google 로그인 링크 (10분 유효):',
+                    '',
+                    url,
+                    '',
+                    '이 URL을 브라우저에서 열고 Google 계정으로 승인해줘.',
+                    '완료되면 localhost:9876으로 자동 리다이렉트되고 토큰이 저장돼.',
+                    '이후 바로 다른 MCP 도구(playstore_*, firebase_* 등) 호출 가능.',
+                ].join('\n'),
+            }],
+    };
+});
 server.tool('mimi_seed_auth_status', 'Mimi Seed MCP 인증 상태 확인', {}, async () => {
     const client = getAuthenticatedClient();
     if (!client) {
@@ -543,6 +690,118 @@ server.tool('mimi_seed_auth_status', 'Mimi Seed MCP 인증 상태 확인', {}, a
     };
 });
 // ══════════════════════════════════════════════════
+// 제출 위험 점검 (Submission Risk Check)
+// ══════════════════════════════════════════════════
+server.tool('playstore_check_submission_risks', [
+    'Google Play 제출 전 위험 요소를 자동으로 점검합니다.',
+    '블로커(반드시 수정)와 경고(권장 수정)로 분류하여 반환합니다.',
+    '점검 항목: 리스팅 완성도(제목/설명/짧은설명), 스크린샷 수, 아이콘, 빌드 존재 여부, 연락처.',
+].join(' '), {
+    packageName: z.string().describe('Android 패키지명 (예: com.example.myapp)'),
+    language: z.string().optional().describe('언어 코드 (기본: ko-KR)'),
+}, async ({ packageName, language }) => {
+    const auth = requireAuth();
+    const risks = await checkPlayStoreRisks(auth, packageName, language ?? 'ko-KR');
+    const text = formatRisks(risks, 'Google Play');
+    return { content: [{ type: 'text', text }] };
+});
+server.tool('appstore_check_submission_risks', [
+    'App Store 제출 전 위험 요소를 자동으로 점검합니다.',
+    '블로커(반드시 수정)와 경고(권장 수정)로 분류하여 반환합니다.',
+    '점검 항목: 메타데이터 완성도(설명/What\'s New/키워드), 스크린샷, TestFlight 빌드, 개인정보처리방침 URL.',
+    'App Store 인증이 필요합니다 (appstore_* 도구 사용 가능 상태여야 함).',
+].join(' '), {
+    appId: z.string().describe('App Store 앱 ID (appstore_list_apps 결과의 id 필드)'),
+}, async ({ appId }) => {
+    const risks = await checkAppStoreRisks(appId);
+    const text = formatRisks(risks, 'App Store');
+    return { content: [{ type: 'text', text }] };
+});
+// ══════════════════════════════════════════════════
+// 스크린샷 해상도 검증 (Screenshot Validation)
+// ══════════════════════════════════════════════════
+server.tool('screenshot_validate', [
+    '로컬 스크린샷 파일의 해상도·파일크기·종횡비를 App Store / Play Store 규격과 비교 검증합니다.',
+    'PNG/JPEG 파일 경로를 배열로 받아 각 파일의 통과 여부와 문제점을 반환합니다.',
+    'platform: "ios" 또는 "android" (기본: ios)',
+    'iOS displayType 예시: APP_IPHONE_69, APP_IPHONE_67, APP_IPHONE_65, APP_IPAD_PRO_3GEN_129',
+    'Android imageType 예시: phoneScreenshots, sevenInchScreenshots, tenInchScreenshots, featureGraphic',
+    '업로드 전 미리 검사하여 리젝 방지에 활용하세요.',
+].join(' '), {
+    filePaths: z.array(z.string()).describe('검증할 이미지 파일 절대경로 배열'),
+    platform: z.enum(['ios', 'android']).optional().describe('플랫폼 (기본: ios)'),
+    displayType: z.string().optional().describe('iOS 디스플레이 타입 (예: APP_IPHONE_67)'),
+    imageType: z.string().optional().describe('Android 이미지 타입 (예: phoneScreenshots)'),
+}, async ({ filePaths, platform, displayType, imageType }) => {
+    const plat = platform ?? 'ios';
+    if (plat === 'ios') {
+        const results = validateAppStoreScreenshots(filePaths, displayType);
+        const text = formatValidationResults(results, 'App Store');
+        return { content: [{ type: 'text', text }] };
+    }
+    else {
+        const results = validatePlayStoreScreenshots(filePaths, imageType ?? 'phoneScreenshots');
+        const text = formatValidationResults(results, 'Google Play');
+        return { content: [{ type: 'text', text }] };
+    }
+});
+// ══════════════════════════════════════════════════
+// AI 릴리즈 노트 생성 (ANTHROPIC_API_KEY 필요)
+// ══════════════════════════════════════════════════
+server.tool('generate_release_notes_from_commits', [
+    'git 커밋 내역을 받아 Claude AI로 앱 스토어용 릴리즈 노트를 생성합니다.',
+    '3가지 톤(간결/상세/마케팅)과 다국어 버전을 동시에 생성합니다.',
+    'ANTHROPIC_API_KEY 환경변수가 필요합니다.',
+    'commits: [{ message, author?, date? }] 형태로 전달하세요.',
+    'locales: 다국어 생성할 로케일 배열 (예: ["ko", "en-US", "ja"])',
+    '생성 후 playstore_update_release_notes 또는 appstore_update_whats_new로 적용하세요.',
+].join(' '), {
+    commits: z.array(z.object({
+        message: z.string(),
+        hash: z.string().optional(),
+        author: z.string().optional(),
+        date: z.string().optional(),
+    })).describe('git 커밋 배열'),
+    appName: z.string().optional().describe('앱 이름 (프롬프트 맥락용)'),
+    locales: z.array(z.string()).optional().describe('다국어 로케일 목록 (예: ["ko", "en-US", "ja"])'),
+}, async ({ commits, appName, locales }) => {
+    const result = await generateReleaseNotesFromCommits(commits, {
+        appName,
+        locales: locales ?? [],
+    });
+    const text = formatGeneratedNotes(result);
+    return { content: [{ type: 'text', text }] };
+});
+// ══════════════════════════════════════════════════
+// AI 리뷰 답변 생성 (ANTHROPIC_API_KEY 필요)
+// ══════════════════════════════════════════════════
+server.tool('generate_review_reply', [
+    'Play Store / App Store 리뷰에 대한 AI 답변 초안을 생성합니다.',
+    'ANTHROPIC_API_KEY 환경변수가 필요합니다.',
+    'tone: friendly(친근) / professional(정중) / empathetic(공감) / brief(간결) — 기본: friendly',
+    'language: ko / en / ja / zh 등 — 기본: ko',
+    '⚠ 생성된 답변은 초안입니다. 게시 전 반드시 검토하세요.',
+    '답변 게시는 playstore_reply_to_review 도구를 사용하세요.',
+].join(' '), {
+    reviewText: z.string().describe('리뷰 원문'),
+    rating: z.number().min(1).max(5).optional().describe('별점 (1~5)'),
+    appName: z.string().optional().describe('앱 이름'),
+    tone: z.enum(['friendly', 'professional', 'empathetic', 'brief']).optional().describe('답변 톤'),
+    language: z.string().optional().describe('답변 언어 코드 (기본: ko)'),
+    developerName: z.string().optional().describe('개발자/팀 이름'),
+}, async ({ reviewText, rating, appName, tone, language, developerName }) => {
+    const result = await generateReviewReply({
+        reviewText,
+        rating,
+        appName,
+        tone: tone ?? 'friendly',
+        language: language ?? 'ko',
+        developerName,
+    });
+    const text = formatReviewReply(result);
+    return { content: [{ type: 'text', text }] };
+});
+// ══════════════════════════════════════════════════
 // Start
 // ══════════════════════════════════════════════════
 async function main() {

package/dist/playstore/tools.d.ts

@@ -1,4 +1,13 @@
 import type { OAuth2Client } from 'google-auth-library';
+export type PlayImageType = 'featureGraphic' | 'icon' | 'phoneScreenshots' | 'promoGraphic' | 'sevenInchScreenshots' | 'tenInchScreenshots' | 'tvBanner' | 'tvScreenshots' | 'wearScreenshots';
+/**
+ * Google Play Developer API (Android Publisher API v3) 래퍼
+ *
+ * 주의: 최초 앱 생성은 API로 불가 (Play Console에서만).
+ * 여기서는 기존 앱의 메타데이터, 빌드, 출시를 관리.
+ */
+export declare const publisher: () => import("googleapis").androidpublisher_v3.Androidpublisher;
+export declare function withEdit<T>(auth: OAuth2Client, packageName: string, fn: (editId: string) => Promise<T>, commit?: boolean): Promise<T>;
 export declare function getAppDetails(auth: OAuth2Client, packageName: string): Promise<import("googleapis").androidpublisher_v3.Schema$AppDetails>;
 export declare function getListing(auth: OAuth2Client, packageName: string, language?: string): Promise<import("googleapis").androidpublisher_v3.Schema$Listing>;
 export declare function updateListing(auth: OAuth2Client, packageName: string, language: string, data: {
@@ -15,6 +24,36 @@ export declare function listTracks(auth: OAuth2Client, packageName: string): Pro
         releaseNotes: import("googleapis").androidpublisher_v3.Schema$LocalizedText[] | undefined;
     }[];
 }[]>;
+export declare function updateReleaseNotes(auth: OAuth2Client, packageName: string, track: string, versionCode: string, language: string, text: string): Promise<import("googleapis").androidpublisher_v3.Schema$Track>;
+/**
+ * 최신 release (versionCode 최대값)의 releaseNotes[language]를 교체/추가.
+ * versionCode를 모를 때 편의용.
+ */
+export declare function updateLatestReleaseNotes(auth: OAuth2Client, packageName: string, track: string, language: string, text: string): Promise<{
+    updatedVersionCodes: string[] | null | undefined;
+    updatedReleaseName: string | null | undefined;
+    releases?: import("googleapis").androidpublisher_v3.Schema$TrackRelease[];
+    track?: string | null;
+}>;
+export declare function listImages(auth: OAuth2Client, packageName: string, language: string, imageType: PlayImageType): Promise<import("googleapis").androidpublisher_v3.Schema$Image[]>;
+export declare function uploadImage(auth: OAuth2Client, packageName: string, language: string, imageType: PlayImageType, filePath: string): Promise<import("googleapis").androidpublisher_v3.Schema$Image | undefined>;
+export declare function deleteAllImages(auth: OAuth2Client, packageName: string, language: string, imageType: PlayImageType): Promise<{
+    ok: boolean;
+    imageType: PlayImageType;
+}>;
+/**
+ * 한 edit 세션 내에서 기존 이미지 전체 삭제 + 새 이미지 순서대로 업로드 + commit.
+ * phoneScreenshots처럼 여러 장 교체 시 효율적 (단일 edit).
+ */
+export declare function replaceImages(auth: OAuth2Client, packageName: string, language: string, imageType: PlayImageType, filePaths: string[]): Promise<{
+    imageType: PlayImageType;
+    count: number;
+    uploaded: {
+        id?: string | null;
+        url?: string | null;
+        sha256?: string | null;
+    }[];
+}>;
 export declare function listReviews(auth: OAuth2Client, packageName: string): Promise<{
     reviewId: string | null | undefined;
     authorName: string | null | undefined;
@@ -27,13 +66,9 @@ export declare function listReviews(auth: OAuth2Client, packageName: string): Pr
 }[]>;
 export declare function replyToReview(auth: OAuth2Client, packageName: string, reviewId: string, replyText: string): Promise<import("googleapis").androidpublisher_v3.Schema$ReviewsReplyResponse>;
 export declare function listInAppProducts(auth: OAuth2Client, packageName: string): Promise<{
-    sku: string | null | undefined;
-    status: string | null | undefined;
-    purchaseType: string | null | undefined;
-    defaultPrice: import("googleapis").androidpublisher_v3.Schema$Price | undefined;
-    listings: {
-        [key: string]: import("googleapis").androidpublisher_v3.Schema$InAppProductListing;
-    } | null | undefined;
+    productId: any;
+    listings: any;
+    purchaseOptions: any;
 }[]>;
 export declare function listSubscriptions(auth: OAuth2Client, packageName: string): Promise<{
     productId: string | null | undefined;

package/dist/playstore/tools.js

@@ -1,14 +1,24 @@
 import { google } from 'googleapis';
 import { JWT } from 'google-auth-library';
+import fs from 'node:fs';
+function mimeTypeFor(filePath) {
+    const ext = filePath.toLowerCase().split('.').pop() ?? '';
+    if (ext === 'png')
+        return 'image/png';
+    if (ext === 'jpg' || ext === 'jpeg')
+        return 'image/jpeg';
+    if (ext === 'webp')
+        return 'image/webp';
+    return 'application/octet-stream';
+}
 /**
  * Google Play Developer API (Android Publisher API v3) 래퍼
  *
  * 주의: 최초 앱 생성은 API로 불가 (Play Console에서만).
  * 여기서는 기존 앱의 메타데이터, 빌드, 출시를 관리.
  */
-const publisher = () => google.androidpublisher('v3');
-// ─── withEdit 헬퍼 ───
-async function withEdit(auth, packageName, fn, commit = false) {
+export const publisher = () => google.androidpublisher('v3');
+export async function withEdit(auth, packageName, fn, commit = false) {
     const res = await publisher().edits.insert({ auth, packageName });
     const editId = res.data.id;
     if (!editId)
@@ -81,6 +91,135 @@ export async function listTracks(auth, packageName) {
         }));
     });
 }
+// ─── 릴리스 노트 업데이트 ───
+//
+// track의 특정 release(versionCode 매칭)에 대해 releaseNotes[language]를
+// 교체/추가. 다른 언어 노트와 다른 release entry는 보존. edit 세션으로
+// tracks.get → 수정 → tracks.update → commit. 이미 라이브(completed) 상태인
+// release도 releaseNotes만은 편집 가능.
+export async function updateReleaseNotes(auth, packageName, track, versionCode, language, text) {
+    return withEdit(auth, packageName, async (editId) => {
+        const current = await publisher().edits.tracks.get({
+            auth, packageName, editId, track,
+        });
+        const releases = current.data.releases ?? [];
+        if (releases.length === 0) {
+            throw new Error(`${track} 트랙에 릴리스가 없어.`);
+        }
+        const target = releases.find((r) => (r.versionCodes ?? []).some((v) => String(v) === String(versionCode)));
+        if (!target) {
+            const available = releases.map((r) => ({
+                name: r.name,
+                versionCodes: r.versionCodes,
+                status: r.status,
+            }));
+            throw new Error(`versionCode "${versionCode}"를 ${track} 트랙에서 찾을 수 없어. 가능한 릴리스: ${JSON.stringify(available)}`);
+        }
+        const notes = target.releaseNotes ?? [];
+        const idx = notes.findIndex((n) => n.language === language);
+        if (idx >= 0)
+            notes[idx] = { language, text };
+        else
+            notes.push({ language, text });
+        target.releaseNotes = notes;
+        const updated = await publisher().edits.tracks.update({
+            auth, packageName, editId, track,
+            requestBody: { track, releases },
+        });
+        return updated.data;
+    }, true);
+}
+/**
+ * 최신 release (versionCode 최대값)의 releaseNotes[language]를 교체/추가.
+ * versionCode를 모를 때 편의용.
+ */
+export async function updateLatestReleaseNotes(auth, packageName, track, language, text) {
+    return withEdit(auth, packageName, async (editId) => {
+        const current = await publisher().edits.tracks.get({
+            auth, packageName, editId, track,
+        });
+        const releases = current.data.releases ?? [];
+        if (releases.length === 0) {
+            throw new Error(`${track} 트랙에 릴리스가 없어.`);
+        }
+        const maxVc = (r) => Math.max(...(r.versionCodes ?? []).map((v) => Number(v)), 0);
+        const target = releases.reduce((best, r) => (maxVc(r) > maxVc(best) ? r : best));
+        const notes = target.releaseNotes ?? [];
+        const idx = notes.findIndex((n) => n.language === language);
+        if (idx >= 0)
+            notes[idx] = { language, text };
+        else
+            notes.push({ language, text });
+        target.releaseNotes = notes;
+        const updated = await publisher().edits.tracks.update({
+            auth, packageName, editId, track,
+            requestBody: { track, releases },
+        });
+        return {
+            ...updated.data,
+            updatedVersionCodes: target.versionCodes,
+            updatedReleaseName: target.name,
+        };
+    }, true);
+}
+// ─── 이미지 (feature graphic / phone screenshots / etc.) ───
+export async function listImages(auth, packageName, language, imageType) {
+    return withEdit(auth, packageName, async (editId) => {
+        const res = await publisher().edits.images.list({
+            auth, packageName, editId, language, imageType,
+        });
+        return res.data.images ?? [];
+    });
+}
+export async function uploadImage(auth, packageName, language, imageType, filePath) {
+    if (!fs.existsSync(filePath))
+        throw new Error(`File not found: ${filePath}`);
+    return withEdit(auth, packageName, async (editId) => {
+        const res = await publisher().edits.images.upload({
+            auth, packageName, editId, language, imageType,
+            media: {
+                mimeType: mimeTypeFor(filePath),
+                body: fs.createReadStream(filePath),
+            },
+        });
+        return res.data.image;
+    }, true);
+}
+export async function deleteAllImages(auth, packageName, language, imageType) {
+    return withEdit(auth, packageName, async (editId) => {
+        await publisher().edits.images.deleteall({
+            auth, packageName, editId, language, imageType,
+        });
+        return { ok: true, imageType };
+    }, true);
+}
+/**
+ * 한 edit 세션 내에서 기존 이미지 전체 삭제 + 새 이미지 순서대로 업로드 + commit.
+ * phoneScreenshots처럼 여러 장 교체 시 효율적 (단일 edit).
+ */
+export async function replaceImages(auth, packageName, language, imageType, filePaths) {
+    for (const p of filePaths) {
+        if (!fs.existsSync(p))
+            throw new Error(`File not found: ${p}`);
+    }
+    return withEdit(auth, packageName, async (editId) => {
+        await publisher().edits.images.deleteall({
+            auth, packageName, editId, language, imageType,
+        });
+        const uploaded = [];
+        for (const filePath of filePaths) {
+            const res = await publisher().edits.images.upload({
+                auth, packageName, editId, language, imageType,
+                media: {
+                    mimeType: mimeTypeFor(filePath),
+                    body: fs.createReadStream(filePath),
+                },
+            });
+            uploaded.push(res.data.image ?? {});
+        }
+        return { imageType, count: uploaded.length, uploaded };
+    }, true);
+}
 // ─── 리뷰 조회 ───
 export async function listReviews(auth, packageName) {
     const res = await publisher().reviews.list({ auth, packageName });
@@ -107,16 +246,15 @@ export async function replyToReview(auth, packageName, reviewId, replyText) {
 }
 // ─── 인앱 상품 조회 ───
 export async function listInAppProducts(auth, packageName) {
-    const res = await publisher().inappproducts.list({
+    const res = await publisher().monetization.onetimeproducts.list({
         auth,
         packageName,
+        pageSize: 100,
     });
-    return (res.data.inappproduct ?? []).map((p) => ({
-        sku: p.sku,
-        status: p.status,
-        purchaseType: p.purchaseType,
-        defaultPrice: p.defaultPrice,
+    return (res.data.oneTimeProducts ?? []).map((p) => ({
+        productId: p.productId,
         listings: p.listings,
+        purchaseOptions: p.purchaseOptions,
     }));
 }
 // ─── 구독 조회 ───

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Cursor / any MCP client.",
   "type": "module",
   "bin": {
@@ -42,8 +42,9 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "googleapis": "^148.0.0",
+    "googleapis": "^171.4.0",
     "jsonwebtoken": "^9.0.3",
     "open": "^10.1.0",
     "zod": "^3.24.0"