@yoonion/mimi-seed-mcp 0.3.40 → 0.5.0

package/dist/registers/firebase.js

@@ -144,4 +144,18 @@ export function registerFirebaseTools(server) {
         const services = await firebase.listEnabledServices(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(services, null, 2) }] };
     });
+    server.tool('firebase_link_analytics', 'Firebase 프로젝트에 Google Analytics(GA4) 링크 → 앱별 measurement 자동 활성화. analyticsAccountId(그 계정에 GA4 property 신규 생성) 또는 analyticsPropertyId(기존 property 링크) 중 하나 필수. 먼저 firebase_enable_common_services 로 firebaseanalytics 활성화 권장. property 이름/web stream 까지 직접 제어하려면 ga4_create_property/ga4_create_data_stream 사용.', {
+        projectId: z.string().describe('Firebase 프로젝트 ID'),
+        analyticsAccountId: z.string().optional().describe('GA 계정 ID (신규 property 생성 위치) — 예: 123456'),
+        analyticsPropertyId: z.string().optional().describe('기존 GA4 property ID 에 링크할 경우'),
+    }, async ({ projectId, analyticsAccountId, analyticsPropertyId }) => {
+        const auth = await requireAuth();
+        const result = await firebase.linkAnalytics(auth, projectId, { analyticsAccountId, analyticsPropertyId });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool('firebase_get_analytics_details', '프로젝트의 GA4 링크 상세 — 연결된 analyticsProperty + 앱↔data stream 매핑 조회.', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
+        const auth = await requireAuth();
+        const details = await firebase.getAnalyticsDetails(auth, projectId);
+        return { content: [{ type: 'text', text: JSON.stringify(details, null, 2) }] };
+    });
 }

package/dist/registers/ga4.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGa4Tools(server: McpServer): void;

package/dist/registers/ga4.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import * as ga4Raw from '../ga4/tools.js';
+import { requireAuth } from '../helpers.js';
+import { friendlyGoogleError } from '../lib/google-errors.js';
+// firebase register 와 동일한 프록시 — raw GaxiosError(SERVICE_DISABLED / 403 /
+// ACCESS_TOKEN_SCOPE_INSUFFICIENT)를 "다음에 뭘 할지" 메시지로 변환. 특히 GA4 는
+// analytics.edit 스코프를 새로 추가했으므로 기존 사용자는 재로그인 안내가 필수.
+const ga4 = new Proxy(ga4Raw, {
+    get(target, prop, receiver) {
+        const orig = Reflect.get(target, prop, receiver);
+        if (typeof orig !== 'function')
+            return orig;
+        return (...args) => {
+            try {
+                const out = orig(...args);
+                if (out && typeof out.then === 'function') {
+                    return out.catch((err) => {
+                        throw friendlyGoogleError(err);
+                    });
+                }
+                return out;
+            }
+            catch (err) {
+                throw friendlyGoogleError(err);
+            }
+        };
+    },
+});
+const PROPERTY_DESC = "GA4 property ID — '123456789' 또는 'properties/123456789'";
+export function registerGa4Tools(server) {
+    server.tool('ga4_list_account_summaries', '접근 가능한 Google Analytics 계정 + 각 계정의 GA4 property 요약. accountId / propertyId 를 확인할 때 먼저 호출. analytics.edit 스코프 필요(없으면 재로그인 안내).', {}, async () => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const summaries = await ga4.listAccountSummaries(auth);
+        return { content: [{ type: 'text', text: JSON.stringify(summaries, null, 2) }] };
+    });
+    server.tool('ga4_list_properties', '특정 GA 계정 하위 GA4 property 목록.', { accountId: z.string().describe("GA 계정 ID — '123' 또는 'accounts/123'") }, async ({ accountId }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const properties = await ga4.listProperties(auth, accountId);
+        return { content: [{ type: 'text', text: JSON.stringify(properties, null, 2) }] };
+    });
+    server.tool('ga4_create_property', '새 GA4 property 생성. 생성 후 ga4_create_data_stream 으로 플랫폼별 stream(웹=measurement ID, 앱=firebaseAppId)을 붙인다.', {
+        accountId: z.string().describe("GA 계정 ID — '123' 또는 'accounts/123'"),
+        displayName: z.string().describe('property 표시 이름 (예: SpeakReward)'),
+        timeZone: z.string().optional().describe("IANA 타임존 (기본 'America/Los_Angeles', 예: 'Asia/Seoul')"),
+        currencyCode: z.string().optional().describe("ISO 4217 통화코드 (기본 'USD', 예: 'KRW')"),
+    }, async ({ accountId, displayName, timeZone, currencyCode }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const property = await ga4.createProperty(auth, { accountId, displayName, timeZone, currencyCode });
+        return { content: [{ type: 'text', text: JSON.stringify(property, null, 2) }] };
+    });
+    server.tool('ga4_create_data_stream', 'GA4 property 에 data stream 생성. web → measurementId(G-XXXX) 반환, android/ios → firebaseAppId 반환(Firebase 링크 시). RN 앱은 android/ios 스트림 사용.', {
+        propertyId: z.string().describe(PROPERTY_DESC),
+        platform: z.enum(['web', 'android', 'ios']).describe('스트림 플랫폼'),
+        displayName: z.string().describe('스트림 표시 이름'),
+        defaultUri: z.string().optional().describe('web 전용 — 사이트 URL (예: https://example.com)'),
+        packageName: z.string().optional().describe('android 전용 — 패키지명 (예: com.example.app)'),
+        bundleId: z.string().optional().describe('ios 전용 — Bundle ID (예: com.example.app)'),
+    }, async ({ propertyId, platform, displayName, defaultUri, packageName, bundleId }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const stream = await ga4.createDataStream(auth, propertyId, {
+            platform,
+            displayName,
+            defaultUri,
+            packageName,
+            bundleId,
+        });
+        return { content: [{ type: 'text', text: JSON.stringify(stream, null, 2) }] };
+    });
+    server.tool('ga4_list_data_streams', 'GA4 property 의 data stream 목록 (measurementId / firebaseAppId 평탄화).', { propertyId: z.string().describe(PROPERTY_DESC) }, async ({ propertyId }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const streams = await ga4.listDataStreams(auth, propertyId);
+        return { content: [{ type: 'text', text: JSON.stringify(streams, 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')"),
+        endDate: z.string().describe("종료일 (YYYY-MM-DD 또는 'today')"),
+        dimensions: z.string().optional().describe('쉼표 구분 dimension (예: date,country). 생략 시 전체 합계'),
+        metrics: z.string().optional().describe('쉼표 구분 metric (기본 activeUsers,eventCount)'),
+    }, async ({ propertyId, startDate, endDate, dimensions, metrics }) => {
+        const auth = await requireAuth(ga4Raw.GA4_SCOPE);
+        const report = await ga4.runReport(auth, propertyId, {
+            startDate,
+            endDate,
+            dimensions: dimensions ? dimensions.split(',').map((d) => d.trim()).filter(Boolean) : undefined,
+            metrics: metrics ? metrics.split(',').map((m) => m.trim()).filter(Boolean) : undefined,
+        });
+        return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }] };
+    });
+}

package/dist/registers/playstore.js

@@ -46,7 +46,7 @@ export function registerPlaystoreTools(server) {
         const listing = await playstore.getListing(auth, packageName, language);
         return { content: [{ type: 'text', text: JSON.stringify(listing, null, 2) }] };
     });
-    server.tool('playstore_update_listing', 'Google Play 스토어 리스팅 수정 (제목, 설명문 변경)', {
+    server.tool('playstore_update_listing', 'Google Play 스토어 리스팅 수정 (제목, 설명문 변경). ⚠️ Play API 편집과 Console 동시 편집은 충돌 — Console에서 같은 리스팅을 편집·미게시 중이면 그 변경이 덮어써질 수 있음.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드 (예: ko-KR, en-US)'),
         title: z.string().optional().describe('앱 제목 (30자 이내)'),
@@ -115,7 +115,7 @@ export function registerPlaystoreTools(server) {
         const images = await playstore.listImages(auth, packageName, language, imageType);
         return { content: [{ type: 'text', text: JSON.stringify(images, null, 2) }] };
     });
-    server.tool('playstore_upload_image', 'Google Play 리스팅 이미지 단일 업로드 (기존 이미지 유지). featureGraphic 1024x500 / icon 512x512 / phoneScreenshots 320~3840px', {
+    server.tool('playstore_upload_image', 'Google Play 리스팅 이미지 단일 업로드 (기존 이미지 유지). featureGraphic 1024x500 / icon 512x512 / phoneScreenshots 320~3840px. ⚠️ 이 작업은 edit을 commit하므로 Play Console의 미게시(저장 전) 리스팅 변경을 덮어쓸 수 있음 — Console에서 같은 앱을 편집 중이면 먼저 저장·게시하거나 텍스트도 update_listing으로 처리하세요.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드'),
         imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),
@@ -125,7 +125,7 @@ export function registerPlaystoreTools(server) {
         const result = await playstore.uploadImage(auth, packageName, language, imageType, filePath);
         return { content: [{ type: 'text', text: `✅ 업로드 완료\n${JSON.stringify(result, null, 2)}` }] };
     });
-    server.tool('playstore_delete_all_images', 'Google Play 리스팅 특정 imageType의 이미지 전체 삭제 (교체 전 정리)', {
+    server.tool('playstore_delete_all_images', 'Google Play 리스팅 특정 imageType의 이미지 전체 삭제 (교체 전 정리). ⚠️ commit이 Play Console의 미게시 리스팅 변경을 덮어쓸 수 있음.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드'),
         imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),
@@ -134,7 +134,7 @@ export function registerPlaystoreTools(server) {
         const result = await playstore.deleteAllImages(auth, packageName, language, imageType);
         return { content: [{ type: 'text', text: `✅ 전체 삭제\n${JSON.stringify(result, null, 2)}` }] };
     });
-    server.tool('playstore_replace_images', 'Google Play 리스팅 이미지 일괄 교체 (한 edit 세션: deleteall → 순서대로 upload → commit). 스크린샷 5~8장 한 번에 교체 시 효율적. 업로드 순서가 스토어 노출 순서', {
+    server.tool('playstore_replace_images', 'Google Play 리스팅 이미지 일괄 교체 (한 edit 세션: deleteall → 순서대로 upload → commit). 스크린샷 5~8장 한 번에 교체 시 효율적. 업로드 순서가 스토어 노출 순서. ⚠️ commit이 Play Console의 미게시 리스팅 변경을 덮어쓸 수 있음.', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드'),
         imageType: z.enum(['featureGraphic', 'icon', 'phoneScreenshots', 'promoGraphic', 'sevenInchScreenshots', 'tenInchScreenshots', 'tvBanner', 'tvScreenshots', 'wearScreenshots']),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.40",
+  "version": "0.5.0",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {
@@ -8,7 +8,10 @@
     "mimi-seed-auth": "dist/auth/cli.js",
     "mimi-seed-appstore-auth": "dist/appstore/setup-cli.js",
     "mimi-seed-playstore-auth": "dist/auth/playstore-setup-cli.js",
-    "mimi-seed-bigquery-auth": "dist/auth/bigquery-setup-cli.js"
+    "mimi-seed-bigquery-auth": "dist/auth/bigquery-setup-cli.js",
+    "mimi-seed-firebase": "dist/firebase/cli.js",
+    "mimi-seed-admob": "dist/admob/cli.js",
+    "mimi-seed-ga4": "dist/ga4/cli.js"
   },
   "files": [
     "dist",
@@ -47,6 +50,9 @@
   "engines": {
     "node": ">=20"
   },
+  "overrides": {
+    "gaxios": "7.1.5"
+  },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.52.0",
     "@modelcontextprotocol/sdk": "^1.12.1",