@yoonion/mimi-seed-mcp 0.6.1 → 0.6.2

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/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/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.1",
+  "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": {