@yoonion/mimi-seed-mcp 0.1.0 → 0.3.0

package/dist/index.js

@@ -2,11 +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',
@@ -281,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);
@@ -374,6 +440,113 @@ server.tool('playstore_verify_service_account', [
     return { content: [{ type: 'text', text: lines.join('\n') }] };
 });
 // ══════════════════════════════════════════════════
+// Google Cloud IAM Tools
+// ══════════════════════════════════════════════════
+// 서비스 계정 생성 → JSON 키 발급 → 프로젝트 IAM 역할 부여까지 자동화.
+// Play Console의 'View financial data' 권한은 Cloud IAM이 아니라 Play Console
+// Users and permissions에서 별도로 부여해야 함 (androidpublisher.users API
+// 또는 수동 UI).
+server.tool('iam_list_service_accounts', '주어진 projectId의 서비스 계정 목록. 이메일 / displayName / disabled 상태 반환.', {
+    projectId: z.string().describe('Google Cloud 프로젝트 ID'),
+}, async ({ projectId }) => {
+    const auth = requireAuth();
+    const accounts = await iam.listServiceAccounts(auth, projectId);
+    return { content: [{ type: 'text', text: JSON.stringify(accounts, null, 2) }] };
+});
+server.tool('iam_create_service_account', '새 서비스 계정 생성. accountId는 이메일의 로컬 파트 (예: "onesub-play-verifier" → onesub-play-verifier@<project>.iam.gserviceaccount.com).', {
+    projectId: z.string().describe('Google Cloud 프로젝트 ID'),
+    accountId: z
+        .string()
+        .regex(/^[a-z][a-z0-9-]{4,28}[a-z0-9]$/, 'lowercase letters, digits, hyphens; 6-30 chars')
+        .describe('서비스 계정 ID (이메일 로컬 파트)'),
+    displayName: z.string().describe('사람이 읽을 표시 이름 (예: "onesub Play verifier")'),
+}, async ({ projectId, accountId, displayName }) => {
+    const auth = requireAuth();
+    const account = await iam.createServiceAccount(auth, projectId, accountId, displayName);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    '✓ 서비스 계정 생성 완료',
+                    '',
+                    `**email**: \`${account.email}\``,
+                    `**displayName**: ${account.displayName}`,
+                    `**uniqueId**: \`${account.uniqueId}\``,
+                    '',
+                    '다음 단계:',
+                    `1. \`iam_create_key("${account.email}")\` — JSON 키 발급`,
+                    `2. \`playstore_verify_service_account\` 로 Play Console 권한까지 확인 (Play Console에서 수동으로 이메일 초대 + 'View financial data' 권한 부여는 별도)`,
+                ].join('\n'),
+            },
+        ],
+    };
+});
+server.tool('iam_list_keys', '주어진 서비스 계정의 기존 키 목록. keyId / keyType / 만료시간 반환. 회수할 키 찾을 때 사용.', {
+    serviceAccount: z.string().describe('서비스 계정 이메일'),
+}, async ({ serviceAccount }) => {
+    const auth = requireAuth();
+    const keys = await iam.listServiceAccountKeys(auth, serviceAccount);
+    return { content: [{ type: 'text', text: JSON.stringify(keys, null, 2) }] };
+});
+server.tool('iam_create_key', [
+    '주어진 서비스 계정의 새 JSON 키를 발급. 응답에 전체 JSON 포함 — 그대로 onesub의 GOOGLE_SERVICE_ACCOUNT_KEY 환경변수로 쓸 수 있음.',
+    '주의: 반환된 JSON은 영구 자격증명이므로 안전하게 보관. 한 서비스 계정당 키 최대 10개 (기존 키 회수 후 발급 필요하면 iam_list_keys로 먼저 확인).',
+].join(' '), {
+    serviceAccount: z.string().describe('서비스 계정 이메일'),
+}, async ({ serviceAccount }) => {
+    const auth = requireAuth();
+    const key = await iam.createServiceAccountKey(auth, serviceAccount);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    '✓ 새 키 발급 완료 — 아래 JSON을 안전하게 보관하세요. **다시 볼 수 없습니다.**',
+                    '',
+                    `**keyId**: \`${key.keyId}\``,
+                    `**clientEmail**: \`${key.clientEmail}\``,
+                    `**projectId**: \`${key.projectId}\``,
+                    '',
+                    '## Service account JSON',
+                    '```json',
+                    key.json,
+                    '```',
+                    '',
+                    'onesub 서버 `GOOGLE_SERVICE_ACCOUNT_KEY` env에 한 줄로 넣을 때:',
+                    '```bash',
+                    "cat service-account.json | tr -d '\\n' | jq -c .",
+                    '```',
+                ].join('\n'),
+            },
+        ],
+    };
+});
+server.tool('iam_add_iam_policy_binding', [
+    '프로젝트 IAM 정책에 (member → role) 바인딩 추가. 이미 같은 조합이 있으면 no-op.',
+    'member 형식: `serviceAccount:<email>` / `user:<email>` / `group:<email>`.',
+    '주의: 이건 Google Cloud IAM 역할입니다. Play Console의 "View financial data" 권한은 별도 — Play Console → Users and permissions에서 부여.',
+].join(' '), {
+    projectId: z.string().describe('Google Cloud 프로젝트 ID'),
+    member: z
+        .string()
+        .describe('권한 받을 주체 (예: serviceAccount:my-sa@my-project.iam.gserviceaccount.com)'),
+    role: z.string().describe('IAM 역할 (예: roles/iam.serviceAccountTokenCreator)'),
+}, async ({ projectId, member, role }) => {
+    const auth = requireAuth();
+    const result = await iam.addProjectIamPolicyBinding(auth, projectId, member, role);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: result.added
+                    ? `✓ 바인딩 추가: \`${member}\` → \`${role}\``
+                    : `• 이미 존재: \`${member}\` → \`${role}\` (no-op)`,
+            },
+        ],
+    };
+});
+// ══════════════════════════════════════════════════
 // App Store Connect Tools
 // ══════════════════════════════════════════════════
 server.tool('appstore_list_apps', 'App Store Connect 앱 목록 조회', {}, async () => {
@@ -392,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) }] };
@@ -405,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) {
@@ -435,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;