@yoonion/mimi-seed-mcp 0.3.26 → 0.3.28

package/dist/registers/checks.js

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import { checkPlayStoreRisks, checkAppStoreRisks, formatRisks } from '../checks/risks.js';
 import { validateAppStoreScreenshots, validatePlayStoreScreenshots, formatValidationResults } from '../checks/screenshots.js';
-import { requireAuth } from '../helpers.js';
+import { requireAuth, requirePlayStoreAuth } from '../helpers.js';
+import * as appstore from '../appstore/tools.js';
+import * as playstore from '../playstore/tools.js';
 export function registerChecksTools(server) {
     server.tool('playstore_check_submission_risks', [
         'Google Play 제출 전 위험 요소를 자동으로 점검합니다.',
@@ -53,4 +55,90 @@ export function registerChecksTools(server) {
             return { content: [{ type: 'text', text }] };
         }
     });
+    server.tool('release_status', [
+        '양 스토어의 동일 버전 상태를 한 번에 조회 — 1.4.x 배포 시 "Play 는 production?", "ASC 는 심사중?" 을',
+        'list_versions + list_tracks 2회 호출 + grep 으로 합치던 멘탈 부담을 단일 응답으로 줄임.',
+        'App Store: appId 가 있을 때 listVersions 에서 version 일치 항목의 state/releaseType/attached build/createdDate.',
+        'Play Store: packageName 이 있을 때 listTracks 에서 동일 versionName 또는 versionCode 가 있는 모든 트랙의 status/versionCodes.',
+        'appId 또는 packageName 둘 다 비어 있으면 에러. 둘 중 하나만 줘도 그 스토어 상태만 조회 가능.',
+    ].join(' '), {
+        version: z.string().describe('조회할 버전명 (예: "1.4.9"). App Store versionString + Play release.name 매칭에 사용.'),
+        appId: z.string().optional().describe('App Store appId (appstore_list_apps 결과). 없으면 App Store 영역 skip.'),
+        packageName: z.string().optional().describe('Play 패키지명 (예: gg.pryzm.coffee). 없으면 Play 영역 skip.'),
+    }, async ({ version, appId, packageName }) => {
+        if (!appId && !packageName) {
+            throw new Error('appId 또는 packageName 중 최소 하나는 지정해야 해요.');
+        }
+        let appStoreSection = null;
+        if (appId) {
+            try {
+                const versions = (await appstore.listVersions(appId));
+                const match = versions.find((v) => v.version === version);
+                if (match) {
+                    // attached build 조회 — listBuilds 까지 가지 않고 단일 versionId 의 build 만.
+                    // appstore.tools.ts 의 attachBuildToVersion 인접 헬퍼는 외부 노출 X — 여기서는
+                    // listBuilds(appId) 의 최근 10개에서 매칭 추정. 일치하는 buildNumber 가 없어도 무방.
+                    const builds = (await appstore.listBuilds(appId).catch(() => []));
+                    appStoreSection = {
+                        versionId: match.id,
+                        version: match.version,
+                        state: match.state,
+                        releaseType: match.releaseType,
+                        createdDate: match.createdDate,
+                        recentBuilds: builds.slice(0, 3).map((b) => ({
+                            id: b.id,
+                            buildNumber: b.version,
+                            processingState: b.processingState,
+                        })),
+                    };
+                }
+                else {
+                    appStoreSection = {
+                        found: false,
+                        available: versions.slice(0, 10).map((v) => ({ version: v.version, state: v.state })),
+                    };
+                }
+            }
+            catch (e) {
+                appStoreSection = { error: e instanceof Error ? e.message : String(e) };
+            }
+        }
+        // ── Play Store ────────────────────────────────────────
+        let playStoreSection = null;
+        if (packageName) {
+            try {
+                const auth = requirePlayStoreAuth(packageName);
+                const tracks = await playstore.listTracks(auth, packageName);
+                // 트랙별로 version 이 매칭되는 release 찾기.
+                //   match 기준: release.name === version (보통 "1.4.9" 또는 "1.4.9 (373)")
+                //   완전 일치가 없으면 prefix 매칭으로 폴백 (releaseName 표기 변동성 흡수).
+                const byTrack = {};
+                for (const t of tracks) {
+                    const exact = t.releases.find((r) => r.name === version);
+                    const prefix = exact ?? t.releases.find((r) => typeof r.name === 'string' && r.name?.startsWith(`${version} `));
+                    if (prefix) {
+                        byTrack[t.track ?? 'unknown'] = {
+                            releaseName: prefix.name,
+                            status: prefix.status,
+                            versionCodes: prefix.versionCodes,
+                        };
+                    }
+                }
+                playStoreSection = Object.keys(byTrack).length > 0
+                    ? byTrack
+                    : {
+                        found: false,
+                        available: tracks.map((t) => ({
+                            track: t.track,
+                            releases: t.releases.map((r) => ({ name: r.name, status: r.status })),
+                        })),
+                    };
+            }
+            catch (e) {
+                playStoreSection = { error: e instanceof Error ? e.message : String(e) };
+            }
+        }
+        const result = { version, appStore: appStoreSection, playStore: playStoreSection };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
 }

package/dist/registers/googleads.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGoogleAdsTools(server: McpServer): void;

package/dist/registers/googleads.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { requireAuth } from '../helpers.js';
+import { saveConfig, loadConfig, requireConfig } from '../googleads/config.js';
+import * as googleads from '../googleads/tools.js';
+export function registerGoogleAdsTools(server) {
+    server.tool('googleads_save_config', 'Google Ads API 설정 저장 (Developer Token + 계정 ID). 최초 1회만 필요.', {
+        developerToken: z.string().describe('Google Ads 콘솔 → 관리자 → API 센터에서 발급한 Developer Token'),
+        customerId: z.string().describe('Google Ads 계정 ID (예: 123-456-7890)'),
+        loginCustomerId: z.string().optional().describe('MCC(관리자) 계정 ID — 하위 계정 접근 시 필요'),
+    }, async ({ developerToken, customerId, loginCustomerId }) => {
+        saveConfig({ developerToken, customerId, loginCustomerId });
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✅ Google Ads 설정 저장 완료.',
+                        `  customerId: ${customerId}`,
+                        loginCustomerId ? `  loginCustomerId: ${loginCustomerId}` : '',
+                        '',
+                        '이제 googleads_list_campaigns 나 googleads_get_uac_report 를 사용할 수 있어.',
+                        '',
+                        '⚠️  Google Ads API는 adwords OAuth 스코프가 필요해.',
+                        '기존 토큰에 스코프가 없으면 npx -y @yoonion/mimi-seed-mcp mimi-seed-auth 로 재인증해줘.',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('googleads_list_campaigns', 'Google Ads 캠페인 목록 조회 (상태, 채널 타입, 일일 예산 포함)', {}, async () => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const campaigns = await googleads.listCampaigns(auth, cfg);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(campaigns, null, 2),
+                }],
+        };
+    });
+    server.tool('googleads_get_campaign_report', '기간별 캠페인 성과 리포트 (클릭, 노출, 비용, 전환수, CPI, CTR)', {
+        startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
+        endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
+    }, async ({ startDate, endDate }) => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const report = await googleads.getCampaignReport(auth, cfg, { startDate, endDate });
+        const totalCost = report.reduce((s, r) => s + r.cost, 0);
+        const totalClicks = report.reduce((s, r) => s + r.clicks, 0);
+        const totalImpressions = report.reduce((s, r) => s + r.impressions, 0);
+        const totalConversions = report.reduce((s, r) => s + r.conversions, 0);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        period: { startDate, endDate },
+                        summary: {
+                            totalCost: Math.round(totalCost * 100) / 100,
+                            totalClicks,
+                            totalImpressions,
+                            totalConversions,
+                            avgCpi: totalConversions > 0 ? Math.round(totalCost / totalConversions * 100) / 100 : null,
+                        },
+                        campaigns: report,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('googleads_get_uac_report', '앱 캠페인(UAC) 리포트 — 앱 설치 캠페인별 설치수, CPI, ROAS 집계', {
+        startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
+        endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
+    }, async ({ startDate, endDate }) => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const report = await googleads.getUacReport(auth, cfg, { startDate, endDate });
+        const totalCost = report.reduce((s, r) => s + r.cost, 0);
+        const totalInstalls = report.reduce((s, r) => s + r.installs, 0);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        period: { startDate, endDate },
+                        summary: {
+                            totalCost: Math.round(totalCost * 100) / 100,
+                            totalInstalls,
+                            avgCpi: totalInstalls > 0 ? Math.round(totalCost / totalInstalls * 100) / 100 : null,
+                            campaignCount: report.length,
+                        },
+                        campaigns: report,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('googleads_list_accessible_customers', 'OAuth 토큰으로 접근 가능한 Google Ads 계정 목록 (API 연결 확인용)', {}, async () => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const result = await googleads.listAccessibleCustomers(auth, cfg);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool('googleads_config_status', 'Google Ads 연동 설정 현황 확인', {}, async () => {
+        const cfg = loadConfig();
+        if (!cfg) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '❌ Google Ads 설정 없음. googleads_save_config 로 먼저 설정해.',
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'configured',
+                        customerId: cfg.customerId,
+                        loginCustomerId: cfg.loginCustomerId ?? null,
+                        hasDeveloperToken: !!cfg.developerToken,
+                    }, null, 2),
+                }],
+        };
+    });
+}

package/dist/registers/playstore.js

@@ -4,6 +4,7 @@ import { saveServiceAccountJsonForPackage, listRegisteredServiceAccounts, delete
 import { createGoogleOneTimePurchase, createGoogleSubscription, updateGoogleProduct, deleteGoogleProduct, listGoogleProducts, } from '@onesub/providers';
 import { requirePlayStoreAuth, requireServiceAccountJson } from '../helpers.js';
 import { buildPlayStoreReleasePlan } from '../checks/plan.js';
+import { validatePlayReleaseNotes, formatIssuesForUser } from '../lib/text-validators.js';
 export function registerPlaystoreTools(server) {
     server.tool('playstore_get_app', 'Google Play 앱 상세 정보 조회', { packageName: z.string().describe('패키지명 (예: com.findthem.app)') }, async ({ packageName }) => {
         const auth = requirePlayStoreAuth(packageName);
@@ -36,6 +37,45 @@ export function registerPlaystoreTools(server) {
         const tracks = await playstore.listTracks(auth, packageName);
         return { content: [{ type: 'text', text: JSON.stringify(tracks, null, 2) }] };
     });
+    server.tool('playstore_get_statistics', 'Google Play Developer Reporting API / Android vitals 통계 조회. ANR/Crash/Error count를 기간·버전·기기·국가 등으로 분해해 확인', {
+        packageName: z.string().describe('패키지명 (예: gg.pryzm.coffee)'),
+        metricSet: z.enum(['anrRate', 'crashRate', 'errorCount'])
+            .default('anrRate')
+            .describe('조회할 Vitals metric set. 기본: anrRate'),
+        startDate: z.string().describe('시작일 YYYY-MM-DD (포함)'),
+        endDate: z.string().describe('종료일 YYYY-MM-DD (보통 exclusive처럼 다음날 지정 권장)'),
+        aggregationPeriod: z.enum(['DAILY', 'HOURLY']).default('DAILY').describe('집계 단위'),
+        dimensions: z.array(z.enum([
+            'apiLevel',
+            'versionCode',
+            'deviceModel',
+            'deviceBrand',
+            'deviceType',
+            'countryCode',
+            'deviceRamBucket',
+            'deviceSocMake',
+            'deviceSocModel',
+            'deviceCpuMake',
+            'deviceCpuModel',
+            'deviceGpuMake',
+            'deviceGpuModel',
+            'deviceGpuVersion',
+            'deviceVulkanVersion',
+            'deviceGlEsVersion',
+            'deviceScreenSize',
+            'deviceScreenDpi',
+        ])).optional().describe('분해 차원. 기본: ["versionCode"]'),
+        metrics: z.array(z.string()).optional().describe('조회 metric. 기본은 metricSet별 핵심 metric + distinctUsers'),
+        filter: z.string().optional().describe('AIP-160 필터. 예: versionCode = 42'),
+        pageSize: z.number().int().min(1).max(100000).optional().describe('최대 행 수'),
+        pageToken: z.string().optional().describe('다음 페이지 토큰'),
+        userCohort: z.enum(['OS_PUBLIC', 'APP_TESTERS', 'OS_BETA']).optional().describe('사용자 cohort'),
+        timeZone: z.string().optional().describe('날짜 기준 timezone. 기본: America/Los_Angeles (Play Reporting API 샘플/지원 기준)'),
+    }, async (args) => {
+        const auth = requirePlayStoreAuth(args.packageName);
+        const result = await playstore.getStatistics(auth, args.packageName, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
     server.tool('playstore_list_images', 'Google Play 리스팅 이미지 목록 조회 (imageType별)', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드 (예: ko-KR)'),
@@ -81,19 +121,73 @@ export function registerPlaystoreTools(server) {
         language: z.string().describe('언어 코드 (예: ko-KR, en-US)'),
         text: z.string().describe('릴리스 노트 본문 (500자 이내)'),
     }, async ({ packageName, track, versionCode, language, text }) => {
+        // ── 사전 lint — 500자 / HTML / 역슬래시 가격(\5000원) round-trip 차단.
+        const validation = validatePlayReleaseNotes(text);
+        if (!validation.ok) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ 릴리스 노트 사전 검증 실패 — API 호출 안 함\n\n${formatIssuesForUser(validation.issues)}\n\n수정 후 다시 호출해주세요.`,
+                    }],
+                isError: true,
+            };
+        }
         const auth = requirePlayStoreAuth(packageName);
         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를 모를 때 편의용", {
+    server.tool('playstore_update_latest_release_notes', [
+        "Google Play 트랙의 최신 릴리스(versionCode 최대) '최근 변경사항' 업데이트 — versionCode를 모를 때 편의용.",
+        '⚠️ 지정한 단일 트랙에만 적용 — 다른 트랙에는 자동 복사되지 않음 (Google Play 정책: promote_release 시점에 노트 캐리됨).',
+        '동일 노트를 여러 트랙에 즉시 반영하려면 syncTracks 옵션 사용 — 지정 트랙들에 대해 순차로 같은 노트 적용.',
+    ].join(' '), {
         packageName: z.string().describe('패키지명'),
-        track: z.enum(['production', 'beta', 'alpha', 'internal']).describe('릴리스 트랙'),
+        track: z.enum(['production', 'beta', 'alpha', 'internal']).describe('1차 적용 트랙'),
         language: z.string().describe('언어 코드 (예: ko-KR)'),
         text: z.string().describe('릴리스 노트 본문 (500자 이내)'),
-    }, async ({ packageName, track, language, text }) => {
+        syncTracks: z.array(z.enum(['production', 'beta', 'alpha', 'internal']))
+            .optional()
+            .describe('추가로 동일 노트 적용할 트랙 배열 (예: ["production"]). 지정 시 1차 track 반영 후 순차 동기화.'),
+    }, async ({ packageName, track, language, text, syncTracks }) => {
+        const validation = validatePlayReleaseNotes(text);
+        if (!validation.ok) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ 릴리스 노트 사전 검증 실패 — API 호출 안 함\n\n${formatIssuesForUser(validation.issues)}\n\n수정 후 다시 호출해주세요.`,
+                    }],
+                isError: true,
+            };
+        }
         const auth = requirePlayStoreAuth(packageName);
-        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)}` }] };
+        // 1차 적용 + 결과 누적.
+        const primaryResult = await playstore.updateLatestReleaseNotes(auth, packageName, track, language, text);
+        const lines = [
+            `✅ ${packageName} ${track} (versionCodes=${JSON.stringify(primaryResult.updatedVersionCodes)}) ${language} 노트 반영`,
+        ];
+        const allResults = { [track]: primaryResult };
+        // 추가 트랙 — 1차와 중복은 skip. 한 트랙 실패해도 나머지 트랙은 계속 시도.
+        if (syncTracks && syncTracks.length > 0) {
+            const targets = syncTracks.filter((t) => t !== track);
+            for (const t of targets) {
+                try {
+                    const r = await playstore.updateLatestReleaseNotes(auth, packageName, t, language, text);
+                    allResults[t] = r;
+                    lines.push(`  ↳ sync ${t} (versionCodes=${JSON.stringify(r.updatedVersionCodes)}) 반영`);
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    allResults[t] = { error: msg };
+                    lines.push(`  ↳ sync ${t} 실패: ${msg}`);
+                }
+            }
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `${lines.join('\n')}\n\n${JSON.stringify(allResults, null, 2)}`,
+                }],
+        };
     });
     server.tool('playstore_list_reviews', 'Google Play 리뷰 목록 조회', { packageName: z.string().describe('패키지명') }, async ({ packageName }) => {
         const auth = requirePlayStoreAuth(packageName);

package/dist/resources.js

@@ -25,7 +25,7 @@ export function registerResources(server) {
                     '# Mimi Seed — 앱 출시·운영 Agent',
                     '',
                     '당신은 Mimi Seed MCP를 통해 인디 개발자의 앱 출시와 운영을 돕는 에이전트입니다.',
-                    'Google Play · App Store · Firebase · AdMob을 직접 제어하는 65+ 도구를 사용할 수 있습니다.',
+                    'Google Play · App Store · Firebase · AdMob · CI/CD · BigQuery를 직접 제어하는 110+ 도구를 사용할 수 있습니다.',
                     '',
                     '## 출시 요청 처리 순서',
                     '',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.26",
-  "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Cursor / any MCP client.",
+  "version": "0.3.28",
+  "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {
     "mimi-seed-mcp": "dist/index.js",
@@ -27,6 +27,7 @@
     "mcp-server",
     "model-context-protocol",
     "claude",
+    "codex",
     "firebase",
     "admob",
     "google-play",