@yoonion/mimi-seed-mcp 0.13.8 → 0.13.10

package/README.md

@@ -84,7 +84,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | 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 (크리덴셜 + 잡) | 10 | `jenkins_create_credential` / `jenkins_upload_keystore` / `jenkins_create_job` / `jenkins_update_job` |
-| GA4 | 6 | `ga4_create_property` / `ga4_create_data_stream` / `ga4_run_report` |
+| GA4 | 8 | `ga4_create_property` / `ga4_create_data_stream` / `ga4_plan_bigquery_link` / `ga4_create_bigquery_link` / `ga4_run_report` |
 | Search Console | 6 | `gsc_inspect_url` / `gsc_search_analytics` / `gsc_submit_sitemap` |
 | Google Ads | 6 | `googleads_list_campaigns` / `googleads_get_uac_report` / `googleads_get_campaign_report` |
 | Facebook | 6 | `facebook_post_photo` / `facebook_post_multi_photo` / `facebook_list_pages` |

package/dist/auth/browser.d.ts

@@ -0,0 +1,2 @@
+/** Open OAuth in the platform's default private/incognito browser window. */
+export declare function openPrivateBrowser(url: string): Promise<void>;

package/dist/auth/browser.js

@@ -0,0 +1,5 @@
+import open, { apps } from 'open';
+/** Open OAuth in the platform's default private/incognito browser window. */
+export async function openPrivateBrowser(url) {
+    await open(url, { app: { name: apps.browserPrivate } });
+}

package/dist/auth/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import readline from 'node:readline';
-import open from 'open';
 import { startAuth, getStoredTokens, ensureFreshAccessToken, } from './google-auth.js';
 import { AuthError, classifyError } from './errors.js';
 import { getMcpOAuthClient } from './constants.js';
 import { AUTH_DOMAINS, DOMAIN_IDS, parseDomainList, summarizeGrantedDomains, } from './scopes.js';
+import { openPrivateBrowser } from './browser.js';
 import { resolveLang } from '../lib/lang.js';
 // ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
 // 여기 있는 건 전부 **터미널에 찍히는 사람용 문자열**이다. errors.ts 가 만드는
@@ -60,7 +60,7 @@ const ko = {
     serverStart: '  🌐 OAuth 콜백 서버 시작: http://localhost:9876/callback',
     serverFail: '  ❌ 콜백 서버 시작 실패',
     pasteUrl: '  📋 아래 URL을 브라우저에 직접 붙여넣으세요:',
-    openingBrowser: '  🌐 기본 브라우저 자동 열기...',
+    openingBrowser: '  🌐 시크릿 브라우저 자동 열기...',
     openingHint: '     (실패 시 --no-browser 로 URL 직접 받기)',
     openFail: (msg) => `  ⚠️  브라우저 자동 열기 실패: ${msg}`,
     openManually: '  📋 직접 열어주세요:',
@@ -124,7 +124,7 @@ const en = {
     serverStart: '  🌐 Starting the OAuth callback server: http://localhost:9876/callback',
     serverFail: '  ❌ Failed to start the callback server',
     pasteUrl: '  📋 Paste this URL into your browser:',
-    openingBrowser: '  🌐 Opening your default browser...',
+    openingBrowser: '  🌐 Opening a private browser window...',
     openingHint: '     (if that fails, use --no-browser to get the URL)',
     openFail: (msg) => `  ⚠️  Could not open the browser: ${msg}`,
     openManually: '  📋 Please open it yourself:',
@@ -337,7 +337,7 @@ async function cmdLogin() {
     else {
         err(M.openingBrowser);
         try {
-            await open(url);
+            await openPrivateBrowser(url);
             err(M.openingHint);
         }
         catch (e) {

package/dist/auth/google-auth.d.ts

@@ -31,7 +31,7 @@ export declare function getAuthenticatedClient(): ReturnType<typeof createOAuth2
 /**
  * OAuth 플로우 시작.
  * URL과 대기 Promise를 즉시 반환. localhost:9876 콜백 서버는 백그라운드로 실행.
- * 호출자가 URL을 사용자에게 전달하거나 `open()`을 직접 호출.
+ * 호출자가 URL을 사용자에게 전달하거나 private 브라우저를 직접 연다.
  * `wait` Promise: 토큰 저장 시 resolve, 타임아웃/에러 시 reject.
  * 재호출 시 기존 세션 자동 정리.
  *
@@ -47,7 +47,7 @@ export declare function startAuth(clientId: string, clientSecret: string, option
     wait: Promise<StoredTokens>;
 };
 /**
- * Interactive login — opens browser, waits for callback.
+ * Interactive login — opens a private browser window, waits for callback.
  * startAuth() 래퍼 — CLI에서 사용.
  */
 export declare function login(clientId: string, clientSecret: string, options?: {

package/dist/auth/google-auth.js

@@ -1,11 +1,11 @@
 import { google } from 'googleapis';
 import http from 'node:http';
-import open from 'open';
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { getMcpOAuthClient } from './constants.js';
 import { AuthError, classifyError } from './errors.js';
+import { openPrivateBrowser } from './browser.js';
 // 스코프 목록의 SSOT 는 scopes.ts (도메인 → 스코프 매핑). 여기서는 로그인 요청 조립만 한다.
 import { scopesForDomains, mergeScopeStrings } from './scopes.js';
 // Primary config dir. Legacy `~/.preseed` is read as a fallback during the
@@ -116,7 +116,7 @@ let activeAuthServer = null;
 /**
  * OAuth 플로우 시작.
  * URL과 대기 Promise를 즉시 반환. localhost:9876 콜백 서버는 백그라운드로 실행.
- * 호출자가 URL을 사용자에게 전달하거나 `open()`을 직접 호출.
+ * 호출자가 URL을 사용자에게 전달하거나 private 브라우저를 직접 연다.
  * `wait` Promise: 토큰 저장 시 resolve, 타임아웃/에러 시 reject.
  * 재호출 시 기존 세션 자동 정리.
  *
@@ -138,7 +138,10 @@ export function startAuth(clientId, clientSecret, options = {}) {
     const authUrl = oauth2Client.generateAuthUrl({
         access_type: 'offline',
         scope: requestedScopes,
-        prompt: 'consent',
+        // Private windows can still share cookies with an already-running private session.
+        // Force Google to show the account chooser so an unrelated signed-in account is
+        // never selected implicitly.
+        prompt: 'consent select_account',
         include_granted_scopes: true,
     });
     const wait = new Promise((resolve, reject) => {
@@ -268,13 +271,13 @@ export function startAuth(clientId, clientSecret, options = {}) {
     return { url: authUrl, wait };
 }
 /**
- * Interactive login — opens browser, waits for callback.
+ * Interactive login — opens a private browser window, waits for callback.
  * startAuth() 래퍼 — CLI에서 사용.
  */
 export async function login(clientId, clientSecret, options = {}) {
     const { url, wait } = startAuth(clientId, clientSecret, options);
-    console.log('🔐 브라우저에서 Google 로그인 중...');
-    open(url);
+    console.log('🔐 시크릿 브라우저에서 Google 계정 선택 중...');
+    await openPrivateBrowser(url);
     return wait;
 }
 /**

package/dist/ga4/tools.d.ts

@@ -16,6 +16,8 @@ export type DataStreamPlatform = 'web' | 'android' | 'ios';
 export declare function normalizeAccountName(accountId: string): string;
 /** '123' | 'properties/123' → 'properties/123' */
 export declare function normalizePropertyName(propertyId: string): string;
+/** 'my-project' | 'projects/my-project' → 'projects/my-project' */
+export declare function normalizeCloudProjectName(projectId: string): string;
 /**
  * dataStreams.create 응답에서 클라이언트가 실제로 필요로 하는 식별자를 평탄화한다.
  * - web stream → measurementId (G-XXXX, gtag/web 연동용)
@@ -76,6 +78,42 @@ export declare function buildDataStreamBody(opts: {
     webStreamData?: undefined;
     androidAppStreamData?: undefined;
 };
+export interface BigQueryLinkOptions {
+    projectId: string;
+    datasetLocation: string;
+    dailyExportEnabled?: boolean;
+    streamingExportEnabled?: boolean;
+    freshDailyExportEnabled?: boolean;
+    includeAdvertisingId?: boolean;
+}
+/** BigQueryLink 생성 요청 본문 조립 (순수 함수 — 테스트 대상). */
+export declare function buildBigQueryLinkBody(opts: BigQueryLinkOptions): {
+    project: string;
+    datasetLocation: string;
+    dailyExportEnabled: boolean;
+    streamingExportEnabled: boolean;
+    freshDailyExportEnabled: boolean;
+    includeAdvertisingId: boolean;
+};
+export declare function flattenBigQueryLink(link: {
+    name?: string | null;
+    project?: string | null;
+    datasetLocation?: string | null;
+    createTime?: string | null;
+    dailyExportEnabled?: boolean | null;
+    streamingExportEnabled?: boolean | null;
+    freshDailyExportEnabled?: boolean | null;
+    includeAdvertisingId?: boolean | null;
+}): {
+    name: string | null;
+    project: string | null;
+    datasetLocation: string | null;
+    createTime: string | null;
+    dailyExportEnabled: boolean;
+    streamingExportEnabled: boolean;
+    freshDailyExportEnabled: boolean;
+    includeAdvertisingId: boolean;
+};
 /** 접근 가능한 GA 계정 + 각 계정의 property 요약. accountId/propertyId 를 찾는 시작점. */
 export declare function listAccountSummaries(auth: Ga4Auth): Promise<import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaAccountSummary[]>;
 /** 계정 하위 GA4 property 목록. accountId: '123' 또는 'accounts/123'. */
@@ -107,6 +145,83 @@ export declare function listDataStreams(auth: Ga4Auth, propertyId: string): Prom
     measurementId: string | null;
     firebaseAppId: string | null;
 }[]>;
+/** GA4 property 에 연결된 BigQuery export 링크 목록. */
+export declare function listBigQueryLinks(auth: Ga4Auth, propertyId: string): Promise<{
+    name: string | null;
+    project: string | null;
+    datasetLocation: string | null;
+    createTime: string | null;
+    dailyExportEnabled: boolean;
+    streamingExportEnabled: boolean;
+    freshDailyExportEnabled: boolean;
+    includeAdvertisingId: boolean;
+}[]>;
+/**
+ * 생성 전 계획. GA4 property 는 BigQuery 링크가 이미 있으면 중복 생성을 시도하지 않는다.
+ * 기존 링크가 있으면 대상 프로젝트가 같아도/달라도 원격 상태를 그대로 보여준다.
+ */
+export declare function planBigQueryLink(auth: Ga4Auth, propertyId: string, opts: BigQueryLinkOptions): Promise<{
+    ready: boolean;
+    action: string;
+    property: string;
+    requestBody: {
+        project: string;
+        datasetLocation: string;
+        dailyExportEnabled: boolean;
+        streamingExportEnabled: boolean;
+        freshDailyExportEnabled: boolean;
+        includeAdvertisingId: boolean;
+    };
+    existingLinks: {
+        name: string | null;
+        project: string | null;
+        datasetLocation: string | null;
+        createTime: string | null;
+        dailyExportEnabled: boolean;
+        streamingExportEnabled: boolean;
+        freshDailyExportEnabled: boolean;
+        includeAdvertisingId: boolean;
+    }[];
+}>;
+/** 계획을 다시 검사한 뒤 BigQuery export 링크 생성. */
+export declare function createBigQueryLink(auth: Ga4Auth, propertyId: string, opts: BigQueryLinkOptions): Promise<{
+    ready: boolean;
+    action: string;
+    property: string;
+    requestBody: {
+        project: string;
+        datasetLocation: string;
+        dailyExportEnabled: boolean;
+        streamingExportEnabled: boolean;
+        freshDailyExportEnabled: boolean;
+        includeAdvertisingId: boolean;
+    };
+    existingLinks: {
+        name: string | null;
+        project: string | null;
+        datasetLocation: string | null;
+        createTime: string | null;
+        dailyExportEnabled: boolean;
+        streamingExportEnabled: boolean;
+        freshDailyExportEnabled: boolean;
+        includeAdvertisingId: boolean;
+    }[];
+    created: boolean;
+    link?: undefined;
+} | {
+    created: boolean;
+    property: string;
+    link: {
+        name: string | null;
+        project: string | null;
+        datasetLocation: string | null;
+        createTime: string | null;
+        dailyExportEnabled: boolean;
+        streamingExportEnabled: boolean;
+        freshDailyExportEnabled: boolean;
+        includeAdvertisingId: boolean;
+    };
+}>;
 export interface RunReportParams {
     startDate: string;
     endDate: string;

package/dist/ga4/tools.js

@@ -10,6 +10,7 @@ import { google } from 'googleapis';
  * (스코프 추가 후 기존 사용자는 1회 재로그인: `npx -y @yoonion/mimi-seed-mcp mimi-seed-auth`)
  */
 const admin = () => google.analyticsadmin('v1beta');
+const adminAlpha = () => google.analyticsadmin('v1alpha');
 const data = () => google.analyticsdata('v1beta');
 /** Admin API(analyticsadmin — property/data stream 생성·조회)가 요구하는 스코프. */
 export const GA4_SCOPE = 'https://www.googleapis.com/auth/analytics.edit';
@@ -33,6 +34,11 @@ export function normalizePropertyName(propertyId) {
     const id = propertyId.trim();
     return id.startsWith('properties/') ? id : `properties/${id}`;
 }
+/** 'my-project' | 'projects/my-project' → 'projects/my-project' */
+export function normalizeCloudProjectName(projectId) {
+    const id = projectId.trim();
+    return id.startsWith('projects/') ? id : `projects/${id}`;
+}
 /**
  * dataStreams.create 응답에서 클라이언트가 실제로 필요로 하는 식별자를 평탄화한다.
  * - web stream → measurementId (G-XXXX, gtag/web 연동용)
@@ -70,6 +76,29 @@ export function buildDataStreamBody(opts) {
             };
     }
 }
+/** BigQueryLink 생성 요청 본문 조립 (순수 함수 — 테스트 대상). */
+export function buildBigQueryLinkBody(opts) {
+    return {
+        project: normalizeCloudProjectName(opts.projectId),
+        datasetLocation: opts.datasetLocation.trim(),
+        dailyExportEnabled: opts.dailyExportEnabled ?? true,
+        streamingExportEnabled: opts.streamingExportEnabled ?? false,
+        freshDailyExportEnabled: opts.freshDailyExportEnabled ?? false,
+        includeAdvertisingId: opts.includeAdvertisingId ?? false,
+    };
+}
+export function flattenBigQueryLink(link) {
+    return {
+        name: link.name ?? null,
+        project: link.project ?? null,
+        datasetLocation: link.datasetLocation ?? null,
+        createTime: link.createTime ?? null,
+        dailyExportEnabled: link.dailyExportEnabled ?? false,
+        streamingExportEnabled: link.streamingExportEnabled ?? false,
+        freshDailyExportEnabled: link.freshDailyExportEnabled ?? false,
+        includeAdvertisingId: link.includeAdvertisingId ?? false,
+    };
+}
 // ─── 계정/속성 디스커버리 ───
 /** 접근 가능한 GA 계정 + 각 계정의 property 요약. accountId/propertyId 를 찾는 시작점. */
 export async function listAccountSummaries(auth) {
@@ -114,6 +143,49 @@ export async function listDataStreams(auth, propertyId) {
     });
     return (res.data.dataStreams ?? []).map((d) => flattenDataStream(d));
 }
+// ─── BigQuery export 링크 ───
+/** GA4 property 에 연결된 BigQuery export 링크 목록. */
+export async function listBigQueryLinks(auth, propertyId) {
+    const res = await adminAlpha().properties.bigQueryLinks.list({
+        auth,
+        parent: normalizePropertyName(propertyId),
+        pageSize: 200,
+    });
+    return (res.data.bigqueryLinks ?? []).map((link) => flattenBigQueryLink(link));
+}
+/**
+ * 생성 전 계획. GA4 property 는 BigQuery 링크가 이미 있으면 중복 생성을 시도하지 않는다.
+ * 기존 링크가 있으면 대상 프로젝트가 같아도/달라도 원격 상태를 그대로 보여준다.
+ */
+export async function planBigQueryLink(auth, propertyId, opts) {
+    const property = normalizePropertyName(propertyId);
+    const requestBody = buildBigQueryLinkBody(opts);
+    const existingLinks = await listBigQueryLinks(auth, property);
+    return {
+        ready: existingLinks.length === 0,
+        action: existingLinks.length === 0 ? 'create' : 'no-op-existing-link',
+        property,
+        requestBody,
+        existingLinks,
+    };
+}
+/** 계획을 다시 검사한 뒤 BigQuery export 링크 생성. */
+export async function createBigQueryLink(auth, propertyId, opts) {
+    const plan = await planBigQueryLink(auth, propertyId, opts);
+    if (!plan.ready) {
+        return { created: false, ...plan };
+    }
+    const res = await adminAlpha().properties.bigQueryLinks.create({
+        auth,
+        parent: plan.property,
+        requestBody: plan.requestBody,
+    });
+    return {
+        created: true,
+        property: plan.property,
+        link: flattenBigQueryLink(res.data),
+    };
+}
 export async function runReport(auth, propertyId, params) {
     const res = await data().properties.runReport({
         auth,

package/dist/registers/ga4.js

@@ -71,6 +71,45 @@ export function registerGa4Tools(server) {
         const streams = await ga4.listDataStreams(auth, propertyId);
         return { content: [{ type: 'text', text: JSON.stringify(streams, null, 2) }] };
     });
+    const bigQueryLinkSchema = {
+        propertyId: z.string().trim().min(1).describe(PROPERTY_DESC),
+        projectId: z.string().trim().min(1).describe("Google Cloud 프로젝트 ID — 'my-project' 또는 'projects/my-project'"),
+        datasetLocation: z.string().trim().min(1).describe("생성할 BigQuery 데이터셋 위치 (예: 'asia-northeast3', 'US', 'EU'). 생성 후 변경 불가"),
+        dailyExportEnabled: z.boolean().optional().describe('일일 내보내기 활성화 (기본 true)'),
+        streamingExportEnabled: z.boolean().optional().describe('스트리밍 내보내기 활성화 (기본 false, 추가 비용 가능)'),
+        freshDailyExportEnabled: z.boolean().optional().describe('Fresh Daily 내보내기 활성화 (기본 false, 지원 속성만 가능)'),
+        includeAdvertisingId: z.boolean().optional().describe('모바일 광고 식별자 포함 (기본 false, 개인정보 정책 확인 필요)'),
+    };
+    server.tool('ga4_plan_bigquery_link', 'GA4 → BigQuery export 링크 생성 계획을 읽기 전용으로 점검. 기존 링크, 대상 프로젝트, 데이터셋 위치와 export 옵션을 반환하며 원격 상태를 변경하지 않는다.', bigQueryLinkSchema, async ({ propertyId, projectId, datasetLocation, dailyExportEnabled, streamingExportEnabled, freshDailyExportEnabled, includeAdvertisingId }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const plan = await ga4.planBigQueryLink(auth, propertyId, {
+            projectId,
+            datasetLocation,
+            dailyExportEnabled,
+            streamingExportEnabled,
+            freshDailyExportEnabled,
+            includeAdvertisingId,
+        });
+        return { content: [{ type: 'text', text: JSON.stringify(plan, null, 2) }] };
+    });
+    server.tool('ga4_create_bigquery_link', 'GA4 → BigQuery export 링크 생성. confirm 생략/false 시 읽기 전용 계획만 반환하고, confirm: true 일 때만 계획을 재검사한 뒤 생성한다. 기존 링크가 있으면 no-op.', {
+        ...bigQueryLinkSchema,
+        confirm: z.boolean().optional().describe('true 명시 시에만 원격 링크 생성. 생략/false 면 계획만 반환'),
+    }, async ({ propertyId, projectId, datasetLocation, dailyExportEnabled, streamingExportEnabled, freshDailyExportEnabled, includeAdvertisingId, confirm }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const opts = {
+            projectId,
+            datasetLocation,
+            dailyExportEnabled,
+            streamingExportEnabled,
+            freshDailyExportEnabled,
+            includeAdvertisingId,
+        };
+        const result = confirm
+            ? await ga4.createBigQueryLink(auth, propertyId, opts)
+            : { preview: true, ...(await ga4.planBigQueryLink(auth, propertyId, opts)) };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
     server.tool('ga4_run_report', 'GA4 Data API 리포트 (활성 사용자·이벤트 등). dimensions/metrics 는 쉼표 구분 GA4 API 이름.', {
         propertyId: z.string().describe(PROPERTY_DESC),
         startDate: z.string().describe("시작일 (YYYY-MM-DD 또는 'NdaysAgo', 'today')"),

package/package.json

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

package/tool-manifest.json

@@ -1,6 +1,6 @@
 {
   "$comment": "등록된 MCP 도구 + 도메인 메타데이터(label·credential·summary)의 SSOT. src/__tests__/tool-manifest.test.ts 가 실제 서버 등록 목록과 diff 하고 메타데이터 정합성을 검사한다. 도구 추가/삭제/개명 시 이 파일을 함께 갱신할 것 — 산문 문서에는 정확한 개수를 쓰지 말고 이 파일을 가리킬 것. mimi-seed://tools/catalog 리소스가 이 파일을 그대로 서빙한다.",
-  "total": 183,
+  "total": 185,
   "domains": {
     "admob": {
       "label": "AdMob",
@@ -169,13 +169,15 @@
     "ga4": {
       "label": "Google Analytics 4",
       "credential": "Google OAuth",
-      "summary": "계정/속성·데이터 스트림 관리, 리포트 실행",
+      "summary": "계정/속성·데이터 스트림·BigQuery export 링크 관리, 리포트 실행",
       "tools": [
         "ga4_list_account_summaries",
         "ga4_list_properties",
         "ga4_create_property",
         "ga4_create_data_stream",
         "ga4_list_data_streams",
+        "ga4_plan_bigquery_link",
+        "ga4_create_bigquery_link",
         "ga4_run_report"
       ]
     },