@yoonion/mimi-seed-mcp 0.6.0 → 0.6.1

package/README.md

@@ -62,13 +62,13 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 ---
 
-## 제공 도구 (147개 · 17개 영역)
+## 제공 도구 (148개 · 17개 영역)
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
 | App Store Connect | 31 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
 | Google Play | 28 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
-| Firebase | 19 | `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` / `firebase_enable_service` |
+| Firebase | 20 | `firebase_create_project` / `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` |
 | AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
 | CI/CD (GitHub Actions · GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |
 | Jenkins (크리덴셜) | 6 | `jenkins_create_credential` / `jenkins_upload_keystore` / `jenkins_save_config` |

package/dist/firebase/tools.d.ts

@@ -9,6 +9,43 @@ export declare function listProjects(auth: OAuth2Client): Promise<{
     projectNumber: string | null | undefined;
 }[]>;
 export declare function getProject(auth: OAuth2Client, projectId: string): Promise<import("googleapis").firebase_v1beta1.Schema$FirebaseProject>;
+/** long-running Operation 하나의 완료 여부를 판정한다. 폴링 루프에서 재사용 + 단독 테스트 가능. */
+export declare function operationOutcome(op: {
+    done?: boolean | null;
+    error?: {
+        message?: string | null;
+    } | null;
+}): {
+    status: 'pending';
+} | {
+    status: 'done';
+} | {
+    status: 'error';
+    message: string;
+};
+/**
+ * getOperation()을 완료(done)까지 폴링한다. getOperation() 자체가 튕기는 것(네트워크 blip)과
+ * operation이 아직 안 끝난 것(pending)을 구분해서, 전자는 몇 번 더 참아주고 후자만 진행 신호로 본다.
+ * intervalMs/maxAttempts는 테스트에서 실시간 대기 없이 검증하기 위한 override.
+ */
+export declare function waitForOperation(getOperation: () => Promise<{
+    done?: boolean | null;
+    error?: {
+        message?: string | null;
+    } | null;
+}>, label: string, opts?: {
+    intervalMs?: number;
+    maxAttempts?: number;
+}): Promise<void>;
+/**
+ * 새 GCP 프로젝트를 만들고 Firebase를 추가한다 (앱 하나당 전용 Firebase 프로젝트 컨벤션).
+ * 둘 다 long-running operation이라 완료까지 폴링한다(최악 케이스 ~2분: 단계당 ~60s × 2단계).
+ * parent 생략 시 계정의 기본 정책대로 생성된다 — 조직 소속이 강제된 계정은 parent
+ * ('organizations/<id>' 또는 'folders/<id>') 없이 호출하면 에러가 난다.
+ */
+export declare function createProject(auth: OAuth2Client, projectId: string, displayName: string, opts?: {
+    parent?: string;
+}): Promise<import("googleapis").firebase_v1beta1.Schema$FirebaseProject>;
 export declare function listAndroidApps(auth: OAuth2Client, projectId: string): Promise<{
     appId: string | null | undefined;
     packageName: string | null | undefined;

package/dist/firebase/tools.js

@@ -19,6 +19,105 @@ export async function getProject(auth, projectId) {
     });
     return res.data;
 }
+const OPERATION_POLL_INTERVAL_MS = 2000;
+const OPERATION_MAX_ATTEMPTS = 30; // ~60s 상한 (operation 하나당) — 프로젝트 생성 + Firebase 추가 두 단계라 최악 ~2분
+const OPERATION_FETCH_RETRY_LIMIT = 3; // getOperation() 자체가 튕기는 경우(네트워크 blip) 허용할 연속 실패 횟수
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** long-running Operation 하나의 완료 여부를 판정한다. 폴링 루프에서 재사용 + 단독 테스트 가능. */
+export function operationOutcome(op) {
+    if (!op.done)
+        return { status: 'pending' };
+    if (op.error)
+        return { status: 'error', message: op.error.message ?? JSON.stringify(op.error) };
+    return { status: 'done' };
+}
+/**
+ * getOperation()을 완료(done)까지 폴링한다. getOperation() 자체가 튕기는 것(네트워크 blip)과
+ * operation이 아직 안 끝난 것(pending)을 구분해서, 전자는 몇 번 더 참아주고 후자만 진행 신호로 본다.
+ * intervalMs/maxAttempts는 테스트에서 실시간 대기 없이 검증하기 위한 override.
+ */
+export async function waitForOperation(getOperation, label, opts = {}) {
+    const intervalMs = opts.intervalMs ?? OPERATION_POLL_INTERVAL_MS;
+    const maxAttempts = opts.maxAttempts ?? OPERATION_MAX_ATTEMPTS;
+    let consecutiveFetchErrors = 0;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        let op;
+        try {
+            op = await getOperation();
+            consecutiveFetchErrors = 0;
+        }
+        catch (err) {
+            consecutiveFetchErrors += 1;
+            if (consecutiveFetchErrors > OPERATION_FETCH_RETRY_LIMIT)
+                throw err;
+            if (attempt < maxAttempts - 1)
+                await sleep(intervalMs);
+            continue;
+        }
+        const outcome = operationOutcome(op);
+        if (outcome.status === 'error')
+            throw new Error(`${label} 실패: ${outcome.message}`);
+        if (outcome.status === 'done')
+            return;
+        if (attempt < maxAttempts - 1)
+            await sleep(intervalMs);
+    }
+    throw new Error(`${label}이(가) 시간 내에 끝나지 않았습니다 — 나중에 firebase_get_project 로 상태를 확인하세요.`);
+}
+/** 방금 만든 프로젝트를 곧바로 조회할 때의 짧은 전파 지연(propagation lag)을 흡수하는 재시도. */
+async function getProjectWithRetry(auth, projectId, attempts = 3, delayMs = 1500) {
+    for (let attempt = 0; attempt < attempts; attempt++) {
+        try {
+            return await getProject(auth, projectId);
+        }
+        catch (err) {
+            if (attempt === attempts - 1)
+                throw err;
+            await sleep(delayMs);
+        }
+    }
+    throw new Error('unreachable');
+}
+/**
+ * 새 GCP 프로젝트를 만들고 Firebase를 추가한다 (앱 하나당 전용 Firebase 프로젝트 컨벤션).
+ * 둘 다 long-running operation이라 완료까지 폴링한다(최악 케이스 ~2분: 단계당 ~60s × 2단계).
+ * parent 생략 시 계정의 기본 정책대로 생성된다 — 조직 소속이 강제된 계정은 parent
+ * ('organizations/<id>' 또는 'folders/<id>') 없이 호출하면 에러가 난다.
+ */
+export async function createProject(auth, projectId, displayName, opts = {}) {
+    const crm = google.cloudresourcemanager('v3');
+    const createRes = await crm.projects.create({
+        auth,
+        requestBody: { projectId, displayName, parent: opts.parent },
+    });
+    const createOpName = createRes.data.name;
+    if (!createOpName)
+        throw new Error('GCP 프로젝트 생성 응답에 operation name이 없습니다.');
+    await waitForOperation(async () => (await crm.operations.get({ auth, name: createOpName })).data, 'GCP 프로젝트 생성');
+    // 이 지점부터는 GCP 프로젝트가 이미 존재한다 — 아래서 실패하면 "다른 projectId로 재시도"가
+    // 아니라 "같은 projectId로 복구"를 안내해야 한다(안 그러면 고아 프로젝트가 계속 쌓일 수 있음).
+    try {
+        const fb = google.firebase('v1beta1');
+        const addRes = await fb.projects.addFirebase({ auth, project: `projects/${projectId}` });
+        const addOpName = addRes.data.name;
+        if (!addOpName)
+            throw new Error('Firebase 추가 응답에 operation name이 없습니다.');
+        await waitForOperation(async () => (await fb.operations.get({ auth, name: addOpName })).data, 'Firebase 추가');
+    }
+    catch (err) {
+        if (err && typeof err === 'object') {
+            err.partialFailureNote = [
+                `⚠️ GCP 프로젝트 \`${projectId}\`는 이미 생성됐습니다.`,
+                '→ 다른 projectId로 재시도하지 말고, 원인을 해결한 뒤 같은 projectId로 다시 시도하거나',
+                `firebase_get_project("${projectId}")로 상태를 확인하세요.`,
+            ].join(' ');
+        }
+        throw err;
+    }
+    return getProjectWithRetry(auth, projectId);
+}
 // ─── Android 앱 ───
 export async function listAndroidApps(auth, projectId) {
     const res = await google.firebase('v1beta1').projects.androidApps.list({

package/dist/lib/google-errors.js

@@ -67,6 +67,15 @@ export function withCause(err, cause) {
     err.cause = cause;
     return err;
 }
+/**
+ * 일부 호출자(예: firebase_create_project)는 "이미 부분적으로 완료된 작업이 있다"는
+ * 사실을 에러 객체에 `partialFailureNote`로 남겨둔다 — 어떤 분기로 친절화되든
+ * (또는 인식 못 해 원본 그대로 통과하든) 그 경고가 사라지지 않도록 항상 앞에 붙인다.
+ */
+function withPartialNote(e, message) {
+    const note = e?.partialFailureNote;
+    return note ? `${note}\n\n${message}` : message;
+}
 /**
  * Firebase / GCP 에러를 친절 메시지로 변환. 신규 사용자가 가장 자주 만나는
  * 'API 미활성화 / 프로젝트 없음 / billing / 권한' 케이스에 다음 행동을 붙인다.
@@ -76,22 +85,28 @@ export function friendlyGoogleError(e) {
     const status = extractHttpStatus(e);
     const reauth = authReauthMessage(text);
     if (reauth)
-        return withCause(new Error(reauth), e);
+        return withCause(new Error(withPartialNote(e, reauth)), e);
     if (/SERVICE_DISABLED|has not been used in project|is disabled|accessNotConfigured/i.test(text)) {
         const url = extractActivationUrl(text);
-        return withCause(new Error([
+        return withCause(new Error(withPartialNote(e, [
             '❌ 필요한 Google API가 비활성화돼 있어요.',
             url ? `→ 활성화: ${url}` : '→ Google Cloud Console에서 해당 API를 활성화한 뒤 다시 시도하세요.',
-        ].join('\n')), e);
+        ].join('\n'))), e);
     }
     if (/BILLING_DISABLED|billing.*(disabled|not enabled|required)/i.test(text)) {
-        return withCause(new Error('❌ 결제(billing)가 비활성화된 프로젝트예요.\n→ Google Cloud Console → 결제 에서 결제 계정을 연결하세요.'), e);
+        return withCause(new Error(withPartialNote(e, '❌ 결제(billing)가 비활성화된 프로젝트예요.\n→ Google Cloud Console → 결제 에서 결제 계정을 연결하세요.')), e);
+    }
+    if (/ALREADY_EXISTS|already exists|already in use/i.test(text)) {
+        return withCause(new Error(withPartialNote(e, '❌ 이미 사용 중인 ID예요 (GCP 프로젝트 ID는 전역에서 유일해야 함).\n→ 다른 projectId로 다시 시도하거나, firebase_get_project 로 소유권을 확인하세요.')), e);
     }
     if (status === 404 || /NOT_FOUND|not found/i.test(text)) {
-        return withCause(new Error('❌ 프로젝트/리소스를 찾을 수 없어요.\n→ firebase_list_projects 로 유효한 projectId를 확인하세요.'), e);
+        return withCause(new Error(withPartialNote(e, '❌ 프로젝트/리소스를 찾을 수 없어요.\n→ firebase_list_projects 로 유효한 projectId를 확인하세요.')), e);
     }
     if (status === 403 || /PERMISSION_DENIED|forbidden|permission/i.test(text)) {
-        return withCause(new Error('❌ 권한 부족 — 이 Google 계정이 해당 프로젝트에 접근 권한이 있는지 확인하세요.'), e);
+        return withCause(new Error(withPartialNote(e, '❌ 권한 부족 — 이 Google 계정이 해당 프로젝트에 접근 권한이 있는지 확인하세요.')), e);
     }
+    const note = e?.partialFailureNote;
+    if (note)
+        return withCause(new Error(`${note}\n\n${text}`), e);
     return e instanceof Error ? e : new Error(text);
 }

package/dist/registers/firebase.js

@@ -37,6 +37,43 @@ export function registerFirebaseTools(server) {
         const project = await firebase.getProject(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(project, null, 2) }] };
     });
+    server.tool('firebase_create_project', [
+        '새 GCP 프로젝트를 만들고 Firebase를 추가한다 (앱 하나당 전용 Firebase 프로젝트 컨벤션 — 기존 프로젝트에',
+        '앱만 추가하려면 firebase_create_android_app/firebase_create_ios_app 사용).',
+        '두 개의 long-running operation(프로젝트 생성 → Firebase 추가)을 순서대로 완료까지 폴링하므로 최악의 경우 2분 정도 걸릴 수 있다.',
+        'projectId는 6-30자, 소문자로 시작, 소문자/숫자/하이픈만 가능(끝에 하이픈 금지).',
+    ].join(' '), {
+        projectId: z
+            .string()
+            .regex(/^[a-z][a-z0-9-]{4,28}[a-z0-9]$/, '소문자로 시작, 소문자/숫자/하이픈 6-30자 (끝에 하이픈 불가)')
+            .describe('새로 만들 GCP/Firebase 프로젝트 ID (예: pryzm-penguinrun)'),
+        displayName: z.string().describe('프로젝트 표시 이름'),
+        parent: z
+            .string()
+            .optional()
+            .describe("조직/폴더 소속이 필요한 계정일 때만: 'organizations/<id>' 또는 'folders/<id>'. 생략 시 계정 기본 정책대로 생성"),
+    }, async ({ projectId, displayName, parent }) => {
+        const auth = await requireAuth();
+        const project = await firebase.createProject(auth, projectId, displayName, { parent });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `✓ Firebase 프로젝트 생성 완료: \`${project.projectId}\``,
+                        '',
+                        `**displayName**: ${project.displayName}`,
+                        `**projectNumber**: ${project.projectNumber}`,
+                        '',
+                        '다음 단계:',
+                        `1. firebase_create_android_app("${project.projectId}", packageName, displayName)`,
+                        `2. firebase_create_ios_app("${project.projectId}", bundleId, displayName)`,
+                        '3. firebase_get_android_config / firebase_get_ios_config 로 설정 파일 다운로드',
+                    ].join('\n'),
+                },
+            ],
+        };
+    });
     server.tool('firebase_list_android_apps', 'Firebase 프로젝트의 Android 앱 목록', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
         const auth = await requireAuth();
         const apps = await firebase.listAndroidApps(auth, projectId);

package/package.json

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