@yoonion/mimi-seed-mcp 0.13.9 → 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/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.9",
+  "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"
       ]
     },