@yoonion/mimi-seed-mcp 0.6.0 → 0.6.2

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/auth/constants.d.ts

@@ -1,3 +1,12 @@
+/**
+ * OAuth client id/secret 해석: env 오버라이드 → 웹 콘솔 원격 조회.
+ * (디스크 캐시(credentials.json) 우선 순위는 호출자 — google-auth.ts
+ * ensureFreshAccessToken — 가 처리하며, 원격 조회 성공 시 디스크에 저장한다.)
+ *
+ * 모든 실패는 message 에 'mcp-auth-config' 를 포함해 던진다 —
+ * errors.ts classifyError 가 이 마커로 CONFIG_FETCH_FAILED 로 분류해
+ * "구글 연결 실패" 같은 오진 대신 정확한 원인/해법을 안내한다.
+ */
 export declare function getMcpOAuthClient(): Promise<{
     clientId: string;
     clientSecret: string;

package/dist/auth/constants.js

@@ -1,5 +1,14 @@
 const WEB_BASE = process.env.MIMI_SEED_WEB_BASE ?? 'https://mimi-seed.pryzm.gg';
 let _cached = null;
+/**
+ * OAuth client id/secret 해석: env 오버라이드 → 웹 콘솔 원격 조회.
+ * (디스크 캐시(credentials.json) 우선 순위는 호출자 — google-auth.ts
+ * ensureFreshAccessToken — 가 처리하며, 원격 조회 성공 시 디스크에 저장한다.)
+ *
+ * 모든 실패는 message 에 'mcp-auth-config' 를 포함해 던진다 —
+ * errors.ts classifyError 가 이 마커로 CONFIG_FETCH_FAILED 로 분류해
+ * "구글 연결 실패" 같은 오진 대신 정확한 원인/해법을 안내한다.
+ */
 export async function getMcpOAuthClient() {
     const id = process.env.MIMI_SEED_GOOGLE_CLIENT_ID ??
         process.env.PRESEED_GOOGLE_CLIENT_ID;
@@ -9,9 +18,32 @@ export async function getMcpOAuthClient() {
         return { clientId: id, clientSecret: secret };
     if (_cached)
         return _cached;
-    const res = await fetch(`${WEB_BASE}/api/mcp-auth-config`);
+    let res;
+    try {
+        res = await fetch(`${WEB_BASE}/api/mcp-auth-config`, {
+            signal: AbortSignal.timeout(10_000),
+        });
+    }
+    catch (e) {
+        const detail = e instanceof Error ? e.message : String(e);
+        throw new Error(`mcp-auth-config fetch failed (${WEB_BASE} 접속 불가: ${detail})`);
+    }
     if (!res.ok)
         throw new Error(`mcp-auth-config fetch failed (${res.status})`);
-    _cached = (await res.json());
+    // body 파싱/검증 실패도 반드시 마커를 달아야 한다 — captive portal 이 200 + HTML 을
+    // 돌려주는 첫 설치 환경에서 raw SyntaxError 가 새면 "재로그인하세요" 로 오진된다.
+    let data;
+    try {
+        data = (await res.json());
+    }
+    catch (e) {
+        const detail = e instanceof Error ? e.message : String(e);
+        throw new Error(`mcp-auth-config fetch failed (응답이 JSON 이 아님: ${detail})`);
+    }
+    // 빈 값 200 응답(서버 env 미설정)을 캐싱하면 프로세스 수명 내내 invalid_client 로 오진된다.
+    if (!data || typeof data !== 'object' || !data.clientId || !data.clientSecret) {
+        throw new Error('mcp-auth-config fetch failed (서버 응답에 clientId/clientSecret 비어 있음)');
+    }
+    _cached = { clientId: data.clientId, clientSecret: data.clientSecret };
     return _cached;
 }

package/dist/auth/errors.d.ts

@@ -1,4 +1,4 @@
-export type AuthErrorCode = 'UNAUTHENTICATED' | 'NO_REFRESH_TOKEN' | 'INVALID_GRANT' | 'RAPT_REQUIRED' | 'INVALID_CLIENT' | 'UNAUTHORIZED_CLIENT' | 'REFRESH_NETWORK_ERROR' | 'REFRESH_UNKNOWN' | 'INSUFFICIENT_SCOPE' | 'CALLBACK_PORT_IN_USE' | 'CALLBACK_TIMEOUT' | 'BROWSER_OPEN_FAILED' | 'USER_DENIED' | 'CODE_EXCHANGE_FAILED' | 'TOKEN_RESPONSE_INVALID';
+export type AuthErrorCode = 'UNAUTHENTICATED' | 'NO_REFRESH_TOKEN' | 'INVALID_GRANT' | 'RAPT_REQUIRED' | 'INVALID_CLIENT' | 'UNAUTHORIZED_CLIENT' | 'REFRESH_NETWORK_ERROR' | 'CONFIG_FETCH_FAILED' | 'REFRESH_UNKNOWN' | 'INSUFFICIENT_SCOPE' | 'CALLBACK_PORT_IN_USE' | 'CALLBACK_TIMEOUT' | 'BROWSER_OPEN_FAILED' | 'USER_DENIED' | 'CODE_EXCHANGE_FAILED' | 'TOKEN_RESPONSE_INVALID';
 export interface AuthErrorPayload {
     code: AuthErrorCode;
     message: string;

package/dist/auth/errors.js

@@ -63,13 +63,28 @@ export function classifyError(e, ctx) {
     if (oauthCode === 'access_denied') {
         return {
             code: 'USER_DENIED',
-            message: '브라우저에서 Google 동의를 거부했습니다.',
-            hint: '다시 시도하고 모든 권한에 동의해주세요.',
+            message: 'Google 동의가 거부되었습니다 (access_denied).',
+            hint: '직접 거부하지 않았다면: 이 OAuth 앱은 Google 미검증(테스트) 상태라 등록된 테스트 사용자만 로그인할 수 있습니다. ' +
+                '운영자에게 Google Cloud Console → OAuth 동의 화면 → 테스트 사용자에 이 계정 추가를 요청한 뒤 재시도하세요. ' +
+                '직접 거부했다면 다시 시도해 모든 권한에 동의해주세요.',
             retriable: true,
             needsReauth: true,
             cause: raw,
         };
     }
+    // OAuth client 설정 조회 실패 — 구글이 아니라 mimi-seed 웹 콘솔 쪽 문제.
+    // 네트워크 분류보다 먼저 검사해야 "oauth2.googleapis.com 연결 실패" 오진을 막는다.
+    if (/mcp-auth-config/i.test(raw)) {
+        return {
+            code: 'CONFIG_FETCH_FAILED',
+            message: 'Mimi Seed 서버에서 OAuth 클라이언트 설정을 받지 못했습니다.',
+            hint: 'mimi-seed.pryzm.gg 접속 가능 여부를 확인하거나, ' +
+                '환경변수 MIMI_SEED_GOOGLE_CLIENT_ID / MIMI_SEED_GOOGLE_CLIENT_SECRET 로 자체 OAuth 클라이언트를 지정하세요.',
+            retriable: true,
+            needsReauth: false,
+            cause: raw,
+        };
+    }
     // 네트워크 / 시스템 레벨
     if (isNetworkError(e, raw)) {
         return {

package/dist/auth/google-auth.js

@@ -316,11 +316,29 @@ export async function ensureFreshAccessToken(marginMs = 300_000) {
             },
         };
     }
-    // refresh 시도 — credentials.json 우선, 없으면 원격에서 클라이언트 조회
+    // refresh 시도 — credentials.json(디스크) 우선. 디스크에 있으면 원격 조회 자체를 안 한다 —
+    // 매시간 refresh 가 웹 콘솔 생존에 의존하면 콘솔 장애가 모든 로컬 도구 호출을 죽인다.
+    // 없을 때만 env → 원격(getMcpOAuthClient) 순으로 받고, 성공 시 디스크에 저장해
+    // 원격 의존을 최초 1회로 끝낸다. 조회 실패는 raw throw 가 아니라 분류된 에러로 반환.
+    let clientId;
+    let clientSecret;
     const stored = getStoredCredentials();
-    const { clientId: defaultId, clientSecret: defaultSecret } = await getMcpOAuthClient();
-    const clientId = stored?.clientId ?? defaultId;
-    const clientSecret = stored?.clientSecret ?? defaultSecret;
+    if (stored?.clientId && stored?.clientSecret) {
+        ({ clientId, clientSecret } = stored);
+    }
+    else {
+        try {
+            ({ clientId, clientSecret } = await getMcpOAuthClient());
+            saveCredentials(clientId, clientSecret);
+        }
+        catch (e) {
+            return {
+                status: 'expired_refresh_failed',
+                tokens,
+                error: classifyError(e, { phase: 'refresh' }),
+            };
+        }
+    }
     const client = createOAuth2Client(clientId, clientSecret);
     client.setCredentials({ refresh_token: tokens.refresh_token });
     try {

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/index.js

@@ -1,52 +1,10 @@
 #!/usr/bin/env node
 import { readFileSync } from 'node:fs';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { registerFirebaseTools } from './registers/firebase.js';
-import { registerAdmobTools } from './registers/admob.js';
-import { registerPlaystoreTools } from './registers/playstore.js';
-import { registerIamTools } from './registers/iam.js';
-import { registerAppstoreTools } from './registers/appstore.js';
-import { registerChecksTools } from './registers/checks.js';
-import { registerAiTools } from './registers/ai.js';
-import { registerBigqueryTools } from './registers/bigquery.js';
-import { registerAuthTools } from './registers/auth.js';
-import { registerCiTools } from './registers/ci.js';
-import { registerInstagramTools } from './registers/instagram.js';
-import { registerFacebookTools } from './registers/facebook.js';
-import { registerGoogleAdsTools } from './registers/googleads.js';
-import { registerGscTools } from './registers/gsc.js';
-import { registerGa4Tools } from './registers/ga4.js';
-import { registerJenkinsTools } from './registers/jenkins.js';
-import { registerAndroidTools } from './registers/android.js';
-import { registerPrompts } from './prompts.js';
-import { registerResources } from './resources.js';
+import { buildServer } from './server.js';
 // dist/index.js 기준 ../package.json — npm 패키지 루트의 버전을 단일 출처로 사용.
 // 하드코딩하면 publish 때마다 serverInfo.version 이 드리프트하므로 런타임에 읽는다.
 const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
-const server = new McpServer({
-    name: 'mimi-seed',
-    version,
-});
-registerFirebaseTools(server);
-registerAdmobTools(server);
-registerPlaystoreTools(server);
-registerIamTools(server);
-registerAppstoreTools(server);
-registerChecksTools(server);
-registerAiTools(server);
-registerBigqueryTools(server);
-registerAuthTools(server);
-registerCiTools(server);
-registerInstagramTools(server);
-registerFacebookTools(server);
-registerGoogleAdsTools(server);
-registerGscTools(server);
-registerGa4Tools(server);
-registerJenkinsTools(server);
-registerAndroidTools(server);
-registerPrompts(server);
-registerResources(server);
 // `npx -y @yoonion/mimi-seed-mcp <subcommand>` 처리.
 // npx는 스코프 패키지의 basename(`mimi-seed-mcp`)을 매치해 이 bin을 실행하므로,
 // 추가 인자(`mimi-seed-auth` 등)는 여기 argv로 흘러들어온다. 이전엔 MCP 서버가
@@ -80,6 +38,7 @@ async function main() {
         ].join('\n'));
         process.exit(2);
     }
+    const server = buildServer(version);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

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/dist/server.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * 서버 조립 단일 지점 — stdio 엔트리(index.ts)와 tool-manifest 스모크 테스트
+ * (src/__tests__/tool-manifest.test.ts)가 공유한다. 새 register 모듈은 반드시
+ * 여기(index.ts 가 아니라)에 추가해야 테스트가 tool-manifest.json 과의 드리프트를 잡는다.
+ */
+export declare function buildServer(version: string): McpServer;

package/dist/server.js

@@ -0,0 +1,51 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerFirebaseTools } from './registers/firebase.js';
+import { registerAdmobTools } from './registers/admob.js';
+import { registerPlaystoreTools } from './registers/playstore.js';
+import { registerIamTools } from './registers/iam.js';
+import { registerAppstoreTools } from './registers/appstore.js';
+import { registerChecksTools } from './registers/checks.js';
+import { registerAiTools } from './registers/ai.js';
+import { registerBigqueryTools } from './registers/bigquery.js';
+import { registerAuthTools } from './registers/auth.js';
+import { registerCiTools } from './registers/ci.js';
+import { registerInstagramTools } from './registers/instagram.js';
+import { registerFacebookTools } from './registers/facebook.js';
+import { registerGoogleAdsTools } from './registers/googleads.js';
+import { registerGscTools } from './registers/gsc.js';
+import { registerGa4Tools } from './registers/ga4.js';
+import { registerJenkinsTools } from './registers/jenkins.js';
+import { registerAndroidTools } from './registers/android.js';
+import { registerPrompts } from './prompts.js';
+import { registerResources } from './resources.js';
+/**
+ * 서버 조립 단일 지점 — stdio 엔트리(index.ts)와 tool-manifest 스모크 테스트
+ * (src/__tests__/tool-manifest.test.ts)가 공유한다. 새 register 모듈은 반드시
+ * 여기(index.ts 가 아니라)에 추가해야 테스트가 tool-manifest.json 과의 드리프트를 잡는다.
+ */
+export function buildServer(version) {
+    const server = new McpServer({
+        name: 'mimi-seed',
+        version,
+    });
+    registerFirebaseTools(server);
+    registerAdmobTools(server);
+    registerPlaystoreTools(server);
+    registerIamTools(server);
+    registerAppstoreTools(server);
+    registerChecksTools(server);
+    registerAiTools(server);
+    registerBigqueryTools(server);
+    registerAuthTools(server);
+    registerCiTools(server);
+    registerInstagramTools(server);
+    registerFacebookTools(server);
+    registerGoogleAdsTools(server);
+    registerGscTools(server);
+    registerGa4Tools(server);
+    registerJenkinsTools(server);
+    registerAndroidTools(server);
+    registerPrompts(server);
+    registerResources(server);
+    return server;
+}

package/package.json

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