@yoonion/mimi-seed-mcp 0.3.36 → 0.3.38

package/dist/android/keystore.d.ts

@@ -0,0 +1,12 @@
+export interface GeneratedKeystore {
+    keystoreBase64: string;
+    storePassword: string;
+    keyAlias: string;
+    keyPassword: string;
+}
+export declare function isKeytoolAvailable(): boolean;
+export declare function generateKeystore(opts: {
+    appName: string;
+    org?: string;
+    country?: string;
+}): GeneratedKeystore;

package/dist/android/keystore.js

@@ -0,0 +1,52 @@
+import { spawnSync } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { readFileSync, unlinkSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+function randomPassword(len = 20) {
+    // alphanumeric — avoid quoting/escape issues in shell / Gradle properties
+    return randomBytes(32).toString('base64url').replace(/[^a-zA-Z0-9]/g, '').slice(0, len);
+}
+export function isKeytoolAvailable() {
+    const cmd = process.platform === 'win32' ? 'where' : 'which';
+    const result = spawnSync(cmd, ['keytool'], { encoding: 'utf-8' });
+    return result.status === 0;
+}
+export function generateKeystore(opts) {
+    const storePassword = randomPassword(20);
+    const keyPassword = randomPassword(20);
+    const keyAlias = 'upload';
+    const org = opts.org ?? 'Supervlabs';
+    const country = opts.country ?? 'KR';
+    const dname = `CN=${opts.appName}, OU=Engineering, O=${org}, L=Seoul, ST=Seoul, C=${country}`;
+    const keystorePath = join(tmpdir(), `mimi-seed-ks-${Date.now()}.jks`);
+    try {
+        const result = spawnSync('keytool', [
+            '-genkeypair', '-v',
+            '-keystore', keystorePath,
+            '-keyalg', 'RSA',
+            '-keysize', '2048',
+            '-validity', '10000',
+            '-alias', keyAlias,
+            '-storepass', storePassword,
+            '-keypass', keyPassword,
+            '-dname', dname,
+            '-storetype', 'JKS',
+        ], { stdio: 'pipe', encoding: 'buffer' });
+        if (result.status !== 0) {
+            const stderr = result.stderr?.toString('utf-8') ?? '';
+            throw new Error(`keytool 실패:\n${stderr}`);
+        }
+        const keystoreBuffer = readFileSync(keystorePath);
+        return {
+            keystoreBase64: keystoreBuffer.toString('base64'),
+            storePassword,
+            keyAlias,
+            keyPassword,
+        };
+    }
+    finally {
+        if (existsSync(keystorePath))
+            unlinkSync(keystorePath);
+    }
+}

package/dist/index.js

@@ -17,6 +17,7 @@ import { registerFacebookTools } from './registers/facebook.js';
 import { registerGoogleAdsTools } from './registers/googleads.js';
 import { registerGscTools } from './registers/gsc.js';
 import { registerJenkinsTools } from './registers/jenkins.js';
+import { registerAndroidTools } from './registers/android.js';
 import { registerPrompts } from './prompts.js';
 import { registerResources } from './resources.js';
 // dist/index.js 기준 ../package.json — npm 패키지 루트의 버전을 단일 출처로 사용.
@@ -41,6 +42,7 @@ registerFacebookTools(server);
 registerGoogleAdsTools(server);
 registerGscTools(server);
 registerJenkinsTools(server);
+registerAndroidTools(server);
 registerPrompts(server);
 registerResources(server);
 // `npx -y @yoonion/mimi-seed-mcp <subcommand>` 처리.

package/dist/registers/android.d.ts

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

package/dist/registers/android.js

@@ -0,0 +1,226 @@
+import { z } from 'zod';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { requirePlayStoreAuth } from '../helpers.js';
+import { getServiceAccountJson } from '../auth/playstore-auth.js';
+import { getAppDetails } from '../playstore/tools.js';
+import { generateKeystore, isKeytoolAvailable } from '../android/keystore.js';
+import { loadJenkinsConfig, requireJenkinsConfig } from '../jenkins/config.js';
+import { upsertSecretFile } from '../jenkins/credentials.js';
+const SA_DIR = join(homedir(), '.mimi-seed', 'play-service-accounts');
+export function registerAndroidTools(server) {
+    // ── 0. 설정 마법사 ─────────────────────────────────────────────────────────
+    server.tool('android_signing_setup', [
+        '⭐ Android 앱 서명/빌드 설정을 시작할 때 가장 먼저 호출하세요.',
+        'Play Console 업로드 이력을 확인해 신규 앱인지 기존 앱인지 판별하고,',
+        'Jenkins credential 등록과 Play Store SA 연결까지 단계별 액션 플랜을 반환합니다.',
+        '"Jenkins에 keystore 등록해줘", "Android 빌드 설정 해줘", "서명 키 설정" 요청 시 이 도구를 먼저 호출하세요.',
+    ].join(' '), {
+        package_name: z.string().describe('Android 패키지명 (예: gg.pryzm.speakmoney)'),
+        project_id: z.string().optional().describe('GCP 프로젝트 ID (SA 생성 시 필요, 선택)'),
+    }, async ({ package_name, project_id }) => {
+        const jenkinsCfg = loadJenkinsConfig();
+        const saJson = getServiceAccountJson(package_name);
+        // Play Console 확인
+        let appStatus = 'unknown';
+        let playNote = '';
+        if (saJson || getServiceAccountJson()) {
+            try {
+                const auth = requirePlayStoreAuth(package_name);
+                await getAppDetails(auth, package_name);
+                appStatus = 'existing';
+            }
+            catch (e) {
+                const msg = e.message ?? String(e);
+                if (msg.includes('404') || msg.includes('notFound') || msg.includes('not found')) {
+                    appStatus = 'new';
+                }
+                else if (msg.includes('403') || msg.includes('forbidden')) {
+                    appStatus = 'new'; // SA는 있지만 권한 없음 = 신규 앱에 아직 초대 안 됨
+                    playNote = '(Play Console SA 권한 없음 — 신규 앱으로 처리)';
+                }
+                else {
+                    playNote = `Play Console 확인 불가: ${msg.slice(0, 100)}`;
+                }
+            }
+        }
+        else {
+            playNote = 'Play Store SA 없음 — 사용자에게 신규/기존 여부를 직접 확인하세요.';
+        }
+        const jenkinsStatus = jenkinsCfg
+            ? `✅ Jenkins 연결됨 (${jenkinsCfg.url})`
+            : '⚠️  Jenkins 미설정 — jenkins_status 호출 후 jenkins_save_config로 먼저 설정하세요.';
+        if (appStatus === 'existing') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `📦 ${package_name} — **기존 앱** (Play Console에 이미 존재)`,
+                            '',
+                            '기존 upload keystore와 비밀번호가 있어야 합니다.',
+                            '분실한 경우 새 앱으로 다시 등록하거나 Play App Signing으로 마이그레이션해야 합니다.',
+                            '',
+                            `Jenkins: ${jenkinsStatus}`,
+                            '',
+                            '── 필요한 정보 ──────────────────────────────────',
+                            '사용자에게 아래 항목을 확인하세요:',
+                            '  1. upload.jks / upload.keystore 파일 경로 (base64로 변환 필요)',
+                            '  2. store password',
+                            '  3. key alias',
+                            '  4. key password',
+                            '  5. Play Store SA JSON 파일 (없으면 setup_playstore_connection으로 생성)',
+                            '',
+                            '── 등록 순서 ─────────────────────────────────────',
+                            '  1. jenkins_upload_keystore(id="speakmoney-android-keystore", keystore_base64=..., file_name="upload.jks")',
+                            '  2. jenkins_create_credential(id="speakmoney-android-store-password", secret=...)',
+                            '  3. jenkins_create_credential(id="speakmoney-android-key-alias", secret=...)',
+                            '  4. jenkins_create_credential(id="speakmoney-android-key-password", secret=...)',
+                            '  5. jenkins_upload_playstore_sa(package_name="gg.pryzm.speakmoney", credential_id="speakmoney-app-key")',
+                            '     └ SA JSON이 없으면 먼저: setup_playstore_connection(packageName="gg.pryzm.speakmoney", projectId="...")',
+                        ].join('\n'),
+                    }],
+            };
+        }
+        // 신규 앱 또는 미확인
+        const keytoolOk = isKeytoolAvailable();
+        const appLabel = appStatus === 'new' ? '**신규 앱**' : '**신규 앱으로 처리** (Play Console 확인 불가)';
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `📦 ${package_name} — ${appLabel}`,
+                        playNote ? `   ${playNote}` : '',
+                        '',
+                        `Jenkins: ${jenkinsStatus}`,
+                        `keytool(Java JDK): ${keytoolOk ? '✅ 설치됨 — 자동 생성 가능' : '❌ 미설치 — android_generate_keystore 호출 불가, 수동 생성 필요'}`,
+                        '',
+                        '── 신규 앱 설정 순서 ─────────────────────────────',
+                        jenkinsCfg ? '' : '  0. jenkins_status → jenkins_save_config (Jenkins 먼저 설정)',
+                        keytoolOk
+                            ? '  1. android_generate_keystore(app_name="SpeakMoney") → keystore + 비밀번호 자동 생성'
+                            : '  1. ⚠️  수동 keystore 생성 후 base64로 인코딩해서 제공 (keytool -genkeypair ...)',
+                        '  2. jenkins_upload_keystore(id="speakmoney-android-keystore", keystore_base64=..., file_name="upload.jks")',
+                        '  3. jenkins_create_credential(id="speakmoney-android-store-password", secret=...)',
+                        '  4. jenkins_create_credential(id="speakmoney-android-key-alias", secret=...)',
+                        '  5. jenkins_create_credential(id="speakmoney-android-key-password", secret=...)',
+                        project_id
+                            ? `  6. setup_playstore_connection(packageName="${package_name}", projectId="${project_id}")`
+                            : `  6. setup_playstore_connection(packageName="${package_name}", projectId="<GCP 프로젝트 ID>")`,
+                        '     └ GCP 프로젝트 ID를 모르면 사용자에게 확인하세요.',
+                        `  7. jenkins_upload_playstore_sa(package_name="${package_name}", credential_id="speakmoney-app-key")`,
+                        '  8. Play Console에서 서비스 계정 초대 (수동, 1회)',
+                        '     → Play Console → 사용자 및 권한 → SA 이메일 → 릴리즈 관리자 권한 부여',
+                        '  9. 첫 AAB 빌드 후 Play Console에 내부 테스트용으로 수동 업로드 (신규 앱 첫 번째만)',
+                    ].filter((l) => l !== undefined).join('\n'),
+                }],
+        };
+    });
+    // ── 1. keystore 자동 생성 ──────────────────────────────────────────────────
+    server.tool('android_generate_keystore', [
+        '새 Android upload keystore (.jks)를 자동 생성합니다.',
+        'Java JDK의 keytool이 설치돼 있어야 합니다.',
+        '생성 후 반환된 keystoreBase64 / storePassword / keyAlias / keyPassword를',
+        'jenkins_upload_keystore 와 jenkins_create_credential 로 Jenkins에 등록하세요.',
+        '비밀번호는 이 응답에서만 확인 가능하니 반드시 Jenkins에 즉시 등록하세요.',
+    ].join(' '), {
+        app_name: z.string().describe('앱 이름 — keystore dname CN에 사용 (예: SpeakMoney)'),
+        org: z.string().optional().default('Supervlabs').describe('조직명 (기본: Supervlabs)'),
+        country: z.string().optional().default('KR').describe('국가 코드 (기본: KR)'),
+    }, async ({ app_name, org, country }) => {
+        if (!isKeytoolAvailable()) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            '❌ keytool이 설치되지 않았습니다.',
+                            '',
+                            'Java JDK를 설치하면 keytool이 포함됩니다:',
+                            '  macOS: brew install openjdk',
+                            '  Ubuntu: sudo apt install default-jdk',
+                            '  Windows: https://adoptium.net/',
+                            '',
+                            '설치 후 다시 android_generate_keystore를 호출하세요.',
+                        ].join('\n'),
+                    }],
+            };
+        }
+        const ks = generateKeystore({ appName: app_name, org, country });
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✅ Android upload keystore 생성 완료',
+                        '',
+                        '── 생성된 값 (지금 바로 Jenkins에 등록하세요) ────',
+                        `keyAlias:      ${ks.keyAlias}`,
+                        `storePassword: ${ks.storePassword}`,
+                        `keyPassword:   ${ks.keyPassword}`,
+                        `keystoreBase64 길이: ${ks.keystoreBase64.length}자 (파일 기준 약 ${Math.round(ks.keystoreBase64.length * 0.75 / 1024)}KB)`,
+                        '',
+                        '── 다음 단계 — 아래 순서대로 호출하세요 ──────────',
+                        `  jenkins_upload_keystore(`,
+                        `    id="speakmoney-android-keystore",`,
+                        `    keystore_base64="${ks.keystoreBase64.slice(0, 20)}...",`,
+                        `    file_name="upload.jks"`,
+                        `  )`,
+                        `  jenkins_create_credential(id="speakmoney-android-store-password", secret="${ks.storePassword}")`,
+                        `  jenkins_create_credential(id="speakmoney-android-key-alias",       secret="${ks.keyAlias}")`,
+                        `  jenkins_create_credential(id="speakmoney-android-key-password",    secret="${ks.keyPassword}")`,
+                        '',
+                        '⚠️  keystoreBase64 전체 값은 아래 별도 블록으로 제공합니다.',
+                        `KEYSTORE_BASE64=${ks.keystoreBase64}`,
+                    ].join('\n'),
+                }],
+        };
+    });
+    // ── 2. Play SA JSON → Jenkins 업로드 ─────────────────────────────────────
+    server.tool('jenkins_upload_playstore_sa', [
+        'setup_playstore_connection으로 생성한 Play Store 서비스 계정 JSON을',
+        'Jenkins Secret File credential로 업로드합니다.',
+        '~/.mimi-seed/play-service-accounts/{package_name}.json 을 읽어 base64로 변환 후 등록합니다.',
+        'setup_playstore_connection 실행 후 반드시 이 도구를 호출하세요.',
+    ].join(' '), {
+        package_name: z.string().describe('Android 패키지명 (예: gg.pryzm.speakmoney)'),
+        credential_id: z.string().default('speakmoney-app-key').describe('Jenkins Credential ID (기본: speakmoney-app-key)'),
+    }, async ({ package_name, credential_id }) => {
+        const saPath = join(SA_DIR, `${package_name}.json`);
+        if (!existsSync(saPath)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `❌ ${package_name} 서비스 계정 JSON이 없습니다.`,
+                            `   경로: ${saPath}`,
+                            '',
+                            '먼저 setup_playstore_connection을 호출해 서비스 계정을 생성하세요.',
+                        ].join('\n'),
+                    }],
+            };
+        }
+        const saJsonRaw = readFileSync(saPath, 'utf-8');
+        let clientEmail = '(파싱 실패)';
+        try {
+            clientEmail = JSON.parse(saJsonRaw).client_email ?? clientEmail;
+        }
+        catch { /* ignore */ }
+        const saBase64 = Buffer.from(saJsonRaw, 'utf-8').toString('base64');
+        const cfg = requireJenkinsConfig();
+        const result = await upsertSecretFile(cfg, credential_id, saBase64, `${package_name}-sa.json`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✅ Play Store SA JSON → Jenkins ${result}: \`${credential_id}\``,
+                        `   서비스 계정: ${clientEmail}`,
+                        `   파일 크기:  ${saJsonRaw.length}자`,
+                        '',
+                        '다음 단계:',
+                        '  Play Console → 설정 → 사용자 및 권한 → 서비스 계정에서',
+                        `  ${clientEmail} 를 찾아 "릴리즈 관리자" 권한을 부여하세요.`,
+                        '  (수동 1회 작업)',
+                    ].join('\n'),
+                }],
+        };
+    });
+}

package/dist/registers/jenkins.js

@@ -1,13 +1,60 @@
 import { z } from 'zod';
-import { requireJenkinsConfig, saveJenkinsConfig } from '../jenkins/config.js';
+import { loadJenkinsConfig, requireJenkinsConfig, saveJenkinsConfig } from '../jenkins/config.js';
 import * as creds from '../jenkins/credentials.js';
 export function registerJenkinsTools(server) {
+    // ── 0. 상태 확인 (항상 첫 번째로 호출) ─────────────────────────────────────
+    server.tool('jenkins_status', [
+        '⭐ Jenkins 관련 작업을 시작하기 전에 반드시 이 도구를 먼저 호출하세요.',
+        '현재 Jenkins 연결 설정(~/.mimi-seed/jenkins.json) 유무를 확인합니다.',
+        '설정이 없으면 사용자에게 Jenkins URL / 사용자 ID / API Token을 물어본 뒤',
+        'jenkins_save_config를 호출해 저장하세요.',
+        'API Token 발급: Jenkins 대시보드 → [사용자 이름] → 설정 → API Token → "Add new Token".',
+        '로컬 Jenkins 없이 회사·외부 서버도 URL만 맞으면 연결 가능합니다.',
+    ].join(' '), {}, async () => {
+        const cfg = loadJenkinsConfig();
+        if (!cfg) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            '⚠️ Jenkins 설정이 없습니다.',
+                            '',
+                            '다음 정보를 사용자에게 확인한 뒤 jenkins_save_config를 호출해주세요:',
+                            '',
+                            '1. Jenkins URL (예: https://jenkins.company.com)',
+                            '2. Jenkins 사용자 ID (예: admin)',
+                            '3. Jenkins API Token',
+                            '   발급 방법: Jenkins 대시보드 → [사용자 이름] → 설정 → API Token → "Add new Token"',
+                            '',
+                            '로컬 Jenkins가 없어도 회사·원격 서버의 URL을 입력하면 됩니다.',
+                        ].join('\n'),
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✅ Jenkins 설정 있음',
+                        `   URL:      ${cfg.url}`,
+                        `   사용자:   ${cfg.username}`,
+                        `   Token:    ${'*'.repeat(8)}`,
+                        '',
+                        'jenkins_list_credentials 로 등록된 credential 목록을 확인하거나,',
+                        'jenkins_create_credential / jenkins_upload_keystore 로 credential을 추가하세요.',
+                    ].join('\n'),
+                }],
+        };
+    });
+    // ── 1. 설정 저장 ───────────────────────────────────────────────────────────
     server.tool('jenkins_save_config', [
-        'Jenkins 서버 연결 설정을 저장합니다.',
-        '저장 위치: ~/.mimi-seed/jenkins.json (mode 0600).',
-        'API Token은 Jenkins 대시보드 → 사용자 → 설정 → API Token에서 발급할 수 있습니다.',
+        'Jenkins 서버 연결 설정을 저장합니다 (~/.mimi-seed/jenkins.json, mode 0600).',
+        '이 도구를 호출하기 전에 사용자에게 URL / username / token을 먼저 확인하세요.',
+        '로컬 Jenkins가 없어도 회사·원격 서버의 URL을 그대로 사용할 수 있습니다.',
+        'API Token 발급: Jenkins 대시보드 → [사용자 이름] → 설정 → API Token → "Add new Token".',
+        '저장 후 jenkins_list_credentials 로 연결을 검증하세요.',
     ].join(' '), {
-        url: z.string().url().describe('Jenkins 기본 URL (예: https://jenkins.example.com)'),
+        url: z.string().url().describe('Jenkins 기본 URL (예: https://jenkins.company.com)'),
         username: z.string().describe('Jenkins 사용자 ID'),
         token: z.string().describe('Jenkins API Token'),
     }, async ({ url, username, token }) => {
@@ -17,15 +64,19 @@ export function registerJenkinsTools(server) {
                     type: 'text',
                     text: [
                         '✅ Jenkins 설정 저장 완료',
-                        `   URL: ${url}`,
+                        `   URL:    ${url}`,
                         `   사용자: ${username}`,
                         '',
-                        'jenkins_list_credentials 로 등록된 credential 목록을 확인하세요.',
+                        '이제 jenkins_list_credentials 로 연결이 잘 됐는지 확인하세요.',
                     ].join('\n'),
                 }],
         };
     });
-    server.tool('jenkins_list_credentials', 'Jenkins에 등록된 credential 목록을 조회합니다 (id / displayName / type).', {}, async () => {
+    // ── 2. Credential 목록 ─────────────────────────────────────────────────────
+    server.tool('jenkins_list_credentials', [
+        'Jenkins에 등록된 credential 목록을 조회합니다 (id / displayName / type).',
+        '설정이 없으면 jenkins_status를 먼저 호출해 연결 정보를 확인하세요.',
+    ].join(' '), {}, async () => {
         const cfg = requireJenkinsConfig();
         const list = await creds.listCredentials(cfg);
         if (list.length === 0) {
@@ -39,10 +90,12 @@ export function registerJenkinsTools(server) {
                 }],
         };
     });
+    // ── 3. Secret Text ─────────────────────────────────────────────────────────
     server.tool('jenkins_create_credential', [
         'Jenkins에 Secret Text credential을 생성하거나 업데이트합니다.',
         '비밀번호, API 키, 앱 시크릿 등 문자열 값에 사용하세요.',
         '같은 id가 이미 존재하면 자동으로 업데이트합니다.',
+        '설정이 없으면 jenkins_status를 먼저 호출하세요.',
     ].join(' '), {
         id: z.string().describe('Credential ID (예: speakmoney-android-key-password)'),
         secret: z.string().describe('저장할 비밀값'),
@@ -57,10 +110,12 @@ export function registerJenkinsTools(server) {
                 }],
         };
     });
+    // ── 4. Secret File (keystore) ──────────────────────────────────────────────
     server.tool('jenkins_upload_keystore', [
         'Jenkins에 Android keystore 파일을 Secret File credential로 업로드합니다.',
         'keystore_base64에 .jks/.p12 파일을 base64로 인코딩한 값을 전달하세요.',
         '같은 id가 이미 존재하면 자동으로 교체합니다.',
+        '설정이 없으면 jenkins_status를 먼저 호출하세요.',
     ].join(' '), {
         id: z.string().describe('Credential ID (예: speakmoney-android-keystore)'),
         keystore_base64: z.string().describe('keystore 파일 내용을 base64로 인코딩한 값'),
@@ -76,7 +131,11 @@ export function registerJenkinsTools(server) {
                 }],
         };
     });
-    server.tool('jenkins_delete_credential', 'Jenkins credential을 삭제합니다. 비가역 작업입니다.', {
+    // ── 5. 삭제 ───────────────────────────────────────────────────────────────
+    server.tool('jenkins_delete_credential', [
+        'Jenkins credential을 삭제합니다. 비가역 작업입니다.',
+        '설정이 없으면 jenkins_status를 먼저 호출하세요.',
+    ].join(' '), {
         id: z.string().describe('삭제할 Credential ID'),
     }, async ({ id }) => {
         const cfg = requireJenkinsConfig();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.36",
+  "version": "0.3.38",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {