@yoonion/mimi-seed-mcp 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @yoonion/mimi-seed-mcp
+
+**Mimi Seed** — Firebase · AdMob · Google Play · App Store Connect를 AI 콘솔에서 관리. Claude Code / Cursor / 기타 MCP 클라이언트에서 한 줄 등록으로 사용.
+
+> 이 패키지는 Mimi Seed의 **MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg> — 향후 `@yoonion/mimi-seed`로 별도 배포 예정.
+
+## 설치
+
+Claude Code:
+
+```bash
+claude mcp add mimi-seed -- npx -y @yoonion/mimi-seed-mcp
+```
+
+Claude Desktop (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mimi-seed": {
+      "command": "npx",
+      "args": ["-y", "@yoonion/mimi-seed-mcp"]
+    }
+  }
+}
+```
+
+## 첫 사용 전 인증
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
+```
+
+브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
+
+App Store Connect까지 쓰려면 별도로:
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth
+```
+
+(App Store Connect → Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력)
+
+## 제공 도구 (약 40개)
+
+| 영역 | 도구 예시 |
+|------|---------|
+| Firebase | `firebase_list_projects` / `firebase_create_android_app` / `firebase_get_android_config` / `firebase_enable_service` |
+| AdMob | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
+| Google Play | `playstore_list_tracks` / `playstore_list_subscriptions` / `playstore_reply_review` / **`playstore_verify_service_account`** |
+| App Store Connect | `appstore_list_apps` / `appstore_list_builds` / `appstore_list_beta_groups` |
+| 상태 | `mimi_seed_auth_status` |
+
+## `playstore_verify_service_account` — 서비스 계정 JSON 검증
+
+[onesub](https://github.com/jeonghwanko/onesub) 같은 서버가 Google Play 영수증을 백그라운드로 검증하려면 OAuth가 아니라 **서비스 계정 JSON**이 필요. 이 도구는 JSON을 붙여넣으면 단계별로 확인:
+
+1. **parse** — JSON 구조 + 필수 필드 (`type`, `client_email`, `private_key`, `project_id`)
+2. **auth** — 실제로 Google에서 OAuth 토큰 받을 수 있는지 (private_key 유효성)
+3. **api** — 'View financial data' 권한 있는지 (`monetization.subscriptions.list` 실 호출)
+
+실패 단계별로 해결 순서까지 안내. 통과하면 한 줄 JSON으로 변환해서 서버 환경변수에 쓸 수 있음.
+
+예:
+
+> (Claude에게) 이 서비스 계정 JSON이 `com.yourapp.id`에 대해 작동하는지 확인해줘:
+> ```json
+> {"type":"service_account", "project_id":"...", ...}
+> ```
+
+## 레거시 호환성
+
+패키지 이름이 `@preseed/mcp-server` / `preseed-mcp` 시절의 데이터는 자동으로 이어받음:
+
+- `~/.preseed/tokens.json` 있으면 읽음 (재인증 불필요)
+- `~/.preseed/appstore.json`도 동일
+- 환경변수 `PRESEED_GOOGLE_CLIENT_ID` / `PRESEED_GOOGLE_CLIENT_SECRET` 계속 인식
+
+새로 쓰는 건 `~/.mimi-seed/`.
+
+## Links
+
+- 웹 콘솔: https://mimi-seed.pryzm.gg
+- 저장소: https://github.com/jeonghwanko/app-gen
+
+MIT © jeonghwanko

package/dist/admob/tools.d.ts

@@ -0,0 +1,39 @@
+import type { OAuth2Client } from 'google-auth-library';
+/**
+ * AdMob API 래퍼
+ * v1: 조회 (stable)
+ * v1beta: 생성 (Limited Access — 대부분 계정에서 403, 시도는 함)
+ */
+export declare function listAccounts(auth: OAuth2Client): Promise<{
+    name: string | null | undefined;
+    publisherId: string | null | undefined;
+    reportingTimeZone: string | null | undefined;
+    currencyCode: string | null | undefined;
+}[]>;
+export declare function listApps(auth: OAuth2Client, accountId: string): Promise<{
+    name: any;
+    appId: any;
+    platform: any;
+    linkedAppInfo: any;
+    manualAppInfo: any;
+}[]>;
+export declare function listAdUnits(auth: OAuth2Client, accountId: string): Promise<{
+    name: any;
+    adUnitId: any;
+    adFormat: any;
+    adTypes: any;
+    displayName: any;
+    appId: any;
+}[]>;
+export declare function getNetworkReport(auth: OAuth2Client, accountId: string, startDate: {
+    year: number;
+    month: number;
+    day: number;
+}, endDate: {
+    year: number;
+    month: number;
+    day: number;
+}): Promise<import("googleapis").admob_v1.Schema$GenerateNetworkReportResponse>;
+export declare function getTodayEarnings(auth: OAuth2Client, accountId: string): Promise<import("googleapis").admob_v1.Schema$GenerateNetworkReportResponse>;
+export declare function createApp(auth: OAuth2Client, accountId: string, platform: 'ANDROID' | 'IOS', displayName: string): Promise<any>;
+export declare function createAdUnit(auth: OAuth2Client, accountId: string, appId: string, displayName: string, adFormat: 'BANNER' | 'INTERSTITIAL' | 'REWARDED' | 'REWARDED_INTERSTITIAL' | 'APP_OPEN' | 'NATIVE'): Promise<any>;

package/dist/admob/tools.js

@@ -0,0 +1,122 @@
+import { google } from 'googleapis';
+/**
+ * AdMob API 래퍼
+ * v1: 조회 (stable)
+ * v1beta: 생성 (Limited Access — 대부분 계정에서 403, 시도는 함)
+ */
+// ─── 계정 ───
+export async function listAccounts(auth) {
+    const admob = google.admob('v1');
+    const res = await admob.accounts.list({ auth, pageSize: 100 });
+    return (res.data.account ?? []).map((a) => ({
+        name: a.name,
+        publisherId: a.publisherId,
+        reportingTimeZone: a.reportingTimeZone,
+        currencyCode: a.currencyCode,
+    }));
+}
+// ─── 앱 ───
+export async function listApps(auth, accountId) {
+    const admobApi = google.admob('v1');
+    const all = [];
+    let pageToken;
+    do {
+        const res = await admobApi.accounts.apps.list({
+            auth,
+            parent: accountId,
+            pageSize: 100,
+            pageToken,
+        });
+        all.push(...(res.data.apps ?? []));
+        pageToken = res.data.nextPageToken ?? undefined;
+    } while (pageToken);
+    return all.map((a) => ({
+        name: a.name,
+        appId: a.appId,
+        platform: a.platform,
+        linkedAppInfo: a.linkedAppInfo,
+        manualAppInfo: a.manualAppInfo,
+    }));
+}
+// ─── 광고 단위 ───
+export async function listAdUnits(auth, accountId) {
+    const admobApi = google.admob('v1');
+    const all = [];
+    let pageToken;
+    do {
+        const res = await admobApi.accounts.adUnits.list({
+            auth,
+            parent: accountId,
+            pageSize: 100,
+            pageToken,
+        });
+        all.push(...(res.data.adUnits ?? []));
+        pageToken = res.data.nextPageToken ?? undefined;
+    } while (pageToken);
+    return all.map((u) => ({
+        name: u.name,
+        adUnitId: u.adUnitId,
+        adFormat: u.adFormat,
+        adTypes: u.adTypes,
+        displayName: u.displayName,
+        appId: u.appId,
+    }));
+}
+// ─── 수익 리포트 ───
+export async function getNetworkReport(auth, accountId, startDate, endDate) {
+    const admob = google.admob('v1');
+    const res = await admob.accounts.networkReport.generate({
+        auth,
+        parent: accountId,
+        requestBody: {
+            reportSpec: {
+                dateRange: { startDate, endDate },
+                dimensions: ['APP', 'AD_UNIT', 'DATE'],
+                metrics: [
+                    'ESTIMATED_EARNINGS',
+                    'AD_REQUESTS',
+                    'IMPRESSIONS',
+                    'CLICKS',
+                    'MATCHED_REQUESTS',
+                ],
+                sortConditions: [{ dimension: 'DATE', order: 'DESCENDING' }],
+            },
+        },
+    });
+    return res.data;
+}
+// ─── 오늘 수익 요약 ───
+export async function getTodayEarnings(auth, accountId) {
+    const now = new Date();
+    const today = { year: now.getFullYear(), month: now.getMonth() + 1, day: now.getDate() };
+    return getNetworkReport(auth, accountId, today, today);
+}
+// ─── v1beta: 앱 생성 (Limited Access) ───
+export async function createApp(auth, accountId, platform, displayName) {
+    // v1beta — 대부분 계정에서 403. Google Account Manager 승인 필요.
+    const admobBeta = google.admob('v1beta');
+    const res = await admobBeta.accounts.apps.create({
+        auth,
+        parent: accountId,
+        requestBody: {
+            platform,
+            manualAppInfo: { displayName },
+        },
+    });
+    return res.data;
+}
+// ─── v1beta: 광고 단위 생성 (Limited Access) ───
+export async function createAdUnit(auth, accountId, appId, displayName, adFormat) {
+    const admobBeta = google.admob('v1beta');
+    const res = await admobBeta.accounts.adUnits.create({
+        auth,
+        parent: accountId,
+        requestBody: {
+            appId,
+            displayName,
+            adFormat,
+            adTypes: ['DISPLAY'],
+        },
+    });
+    return res.data;
+}

package/dist/appstore/auth.d.ts

@@ -0,0 +1,9 @@
+export interface AppStoreCredentials {
+    issuerId: string;
+    keyId: string;
+    privateKey: string;
+}
+export declare function getAppStoreCredentials(): AppStoreCredentials | null;
+export declare function saveAppStoreCredentials(creds: AppStoreCredentials): void;
+export declare function generateToken(creds: AppStoreCredentials): string;
+export declare function getAuthHeaders(): Record<string, string> | null;

package/dist/appstore/auth.js

@@ -0,0 +1,53 @@
+import jwt from 'jsonwebtoken';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+// Primary location under ~/.mimi-seed. Legacy ~/.preseed read as fallback
+// during the rebrand window so existing App Store Connect sessions don't
+// force a re-setup.
+const CONFIG_PATH = path.join(os.homedir(), '.mimi-seed', 'appstore.json');
+const LEGACY_CONFIG_PATH = path.join(os.homedir(), '.preseed', 'appstore.json');
+export function getAppStoreCredentials() {
+    const pathToRead = fs.existsSync(CONFIG_PATH)
+        ? CONFIG_PATH
+        : fs.existsSync(LEGACY_CONFIG_PATH)
+            ? LEGACY_CONFIG_PATH
+            : null;
+    if (!pathToRead)
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(pathToRead, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveAppStoreCredentials(creds) {
+    const dir = path.dirname(CONFIG_PATH);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(creds, null, 2), { mode: 0o600 });
+}
+export function generateToken(creds) {
+    const now = Math.floor(Date.now() / 1000);
+    return jwt.sign({
+        iss: creds.issuerId,
+        iat: now,
+        exp: now + 20 * 60, // 20분
+        aud: 'appstoreconnect-v1',
+    }, creds.privateKey, {
+        algorithm: 'ES256',
+        header: {
+            alg: 'ES256',
+            kid: creds.keyId,
+            typ: 'JWT',
+        },
+    });
+}
+export function getAuthHeaders() {
+    const creds = getAppStoreCredentials();
+    if (!creds)
+        return null;
+    const token = generateToken(creds);
+    return { Authorization: `Bearer ${token}` };
+}

package/dist/appstore/setup-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/appstore/setup-cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { saveAppStoreCredentials, getAppStoreCredentials } from './auth.js';
+import readline from 'node:readline';
+import fs from 'node:fs';
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((r) => rl.question(q, r));
+async function main() {
+    console.log('');
+    console.log('  🍎 Mimi Seed — App Store Connect 연결');
+    console.log('');
+    const existing = getAppStoreCredentials();
+    if (existing) {
+        console.log(`  ✅ 이미 연결됨 (Key ID: ${existing.keyId})`);
+        const answer = await ask('  다시 설정할래? (y/N): ');
+        if (answer.toLowerCase() !== 'y') {
+            rl.close();
+            return;
+        }
+    }
+    console.log('  App Store Connect에서 API Key를 만들어야 해:');
+    console.log('  https://appstoreconnect.apple.com/access/integrations/api');
+    console.log('');
+    console.log('  1. "키 생성" 클릭');
+    console.log('  2. 이름: Mimi Seed, 역할: Admin');
+    console.log('  3. .p8 파일 다운로드 (1회만 가능!)');
+    console.log('');
+    const issuerId = await ask('  Issuer ID: ');
+    const keyId = await ask('  Key ID: ');
+    const p8Path = await ask('  .p8 파일 경로: ');
+    const trimmedPath = p8Path.trim().replace(/^["']|["']$/g, '');
+    if (!fs.existsSync(trimmedPath)) {
+        console.log(`  ❌ 파일 없음: ${trimmedPath}`);
+        rl.close();
+        process.exit(1);
+    }
+    const privateKey = fs.readFileSync(trimmedPath, 'utf-8');
+    saveAppStoreCredentials({
+        issuerId: issuerId.trim(),
+        keyId: keyId.trim(),
+        privateKey,
+    });
+    console.log('');
+    console.log('  ✅ 연결 완료!');
+    console.log('');
+    console.log('  이제 Claude Code에서:');
+    console.log('    "내 앱스토어 앱 목록 보여줘"');
+    console.log('    "TestFlight 빌드 목록 보여줘"');
+    console.log('');
+    rl.close();
+}
+main();

package/dist/appstore/tools.d.ts

@@ -0,0 +1,7 @@
+export declare function listApps(): Promise<any>;
+export declare function getApp(appId: string): Promise<any>;
+export declare function listVersions(appId: string): Promise<any>;
+export declare function getVersionLocalizations(versionId: string): Promise<any>;
+export declare function listBuilds(appId: string): Promise<any>;
+export declare function listBetaGroups(appId: string): Promise<any>;
+export declare function getAppInfo(appId: string): Promise<any>;

package/dist/appstore/tools.js

@@ -0,0 +1,119 @@
+import { getAuthHeaders } from './auth.js';
+/**
+ * App Store Connect API v1 래퍼
+ * https://developer.apple.com/documentation/appstoreconnectapi
+ */
+const BASE = 'https://api.appstoreconnect.apple.com/v1';
+async function apiGet(path, params) {
+    const headers = getAuthHeaders();
+    if (!headers)
+        throw new Error([
+            '❌ App Store Connect 인증이 필요해.',
+            '',
+            '터미널에서 실행:',
+            '  cd c:/users/turbo08/app-gen/packages/mcp-server',
+            '  npx tsx src/appstore/setup-cli.ts',
+            '',
+            'API Key가 필요해:',
+            '  App Store Connect > Users and Access > Integrations > Keys',
+        ].join('\n'));
+    const url = new URL(`${BASE}${path}`);
+    if (params) {
+        for (const [k, v] of Object.entries(params))
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), { headers });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`App Store API ${res.status}: ${body}`);
+    }
+    return res.json();
+}
+// ─── 앱 ───
+export async function listApps() {
+    const data = await apiGet('/apps', {
+        'fields[apps]': 'name,bundleId,sku,primaryLocale,contentRightsDeclaration',
+        'limit': '200',
+    });
+    return (data.data ?? []).map((a) => ({
+        id: a.id,
+        name: a.attributes?.name,
+        bundleId: a.attributes?.bundleId,
+        sku: a.attributes?.sku,
+        primaryLocale: a.attributes?.primaryLocale,
+    }));
+}
+export async function getApp(appId) {
+    const data = await apiGet(`/apps/${appId}`, {
+        'fields[apps]': 'name,bundleId,sku,primaryLocale,contentRightsDeclaration',
+        'include': 'appStoreVersions',
+    });
+    return data.data;
+}
+// ─── 버전 ───
+export async function listVersions(appId) {
+    const data = await apiGet(`/apps/${appId}/appStoreVersions`, {
+        'fields[appStoreVersions]': 'versionString,appStoreState,releaseType,createdDate',
+        'limit': '10',
+    });
+    return (data.data ?? []).map((v) => ({
+        id: v.id,
+        version: v.attributes?.versionString,
+        state: v.attributes?.appStoreState,
+        releaseType: v.attributes?.releaseType,
+        createdDate: v.attributes?.createdDate,
+    }));
+}
+// ─── 로컬라이제이션 (메타데이터) ───
+export async function getVersionLocalizations(versionId) {
+    const data = await apiGet(`/appStoreVersions/${versionId}/appStoreVersionLocalizations`, {
+        'fields[appStoreVersionLocalizations]': 'locale,description,keywords,promotionalText,whatsNew',
+    });
+    return (data.data ?? []).map((l) => ({
+        id: l.id,
+        locale: l.attributes?.locale,
+        description: l.attributes?.description,
+        keywords: l.attributes?.keywords,
+        promotionalText: l.attributes?.promotionalText,
+        whatsNew: l.attributes?.whatsNew,
+    }));
+}
+// ─── 빌드 ───
+export async function listBuilds(appId) {
+    const data = await apiGet(`/builds`, {
+        'filter[app]': appId,
+        'fields[builds]': 'version,uploadedDate,processingState,buildAudienceType',
+        'sort': '-uploadedDate',
+        'limit': '10',
+    });
+    return (data.data ?? []).map((b) => ({
+        id: b.id,
+        version: b.attributes?.version,
+        uploadedDate: b.attributes?.uploadedDate,
+        processingState: b.attributes?.processingState,
+    }));
+}
+// ─── TestFlight 베타 그룹 ───
+export async function listBetaGroups(appId) {
+    const data = await apiGet(`/apps/${appId}/betaGroups`, {
+        'fields[betaGroups]': 'name,isInternalGroup,publicLink,publicLinkEnabled',
+    });
+    return (data.data ?? []).map((g) => ({
+        id: g.id,
+        name: g.attributes?.name,
+        isInternal: g.attributes?.isInternalGroup,
+        publicLink: g.attributes?.publicLink,
+        publicLinkEnabled: g.attributes?.publicLinkEnabled,
+    }));
+}
+// ─── 앱 정보 (카테고리 등) ───
+export async function getAppInfo(appId) {
+    const data = await apiGet(`/apps/${appId}/appInfos`, {
+        'fields[appInfos]': 'appStoreState,appStoreAgeRating,brazilAgeRating',
+    });
+    return (data.data ?? []).map((i) => ({
+        id: i.id,
+        state: i.attributes?.appStoreState,
+        ageRating: i.attributes?.appStoreAgeRating,
+    }));
+}

package/dist/auth/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/auth/cli.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { login, getStoredTokens } from './google-auth.js';
+import { MIMI_SEED_CLIENT_ID, MIMI_SEED_CLIENT_SECRET } from './constants.js';
+import readline from 'node:readline';
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+const ask = (q) => new Promise((r) => rl.question(q, r));
+async function main() {
+    console.log('');
+    console.log('  ☕ Mimi Seed — Google 계정 연결');
+    console.log('');
+    const existing = getStoredTokens();
+    if (existing) {
+        console.log('  ✅ 이미 연결되어 있어.');
+        console.log('');
+        const answer = await ask('  다시 연결할래? (y/N): ');
+        if (answer.toLowerCase() !== 'y') {
+            rl.close();
+            return;
+        }
+    }
+    console.log('');
+    console.log('  🌐 브라우저 열게. Google 계정으로 로그인해줘.');
+    console.log('');
+    try {
+        await login(MIMI_SEED_CLIENT_ID, MIMI_SEED_CLIENT_SECRET);
+        console.log('');
+        console.log('  ✅ 연결 완료!');
+        console.log('');
+        console.log('  이제 Claude Code에서 이렇게 쓸 수 있어:');
+        console.log('    "내 Firebase 프로젝트 보여줘"');
+        console.log('    "새 Android 앱 등록해줘"');
+        console.log('    "google-services.json 다운로드해줘"');
+        console.log('');
+    }
+    catch (err) {
+        console.error('  ❌ 연결 실패:', err);
+    }
+    rl.close();
+}
+main();

package/dist/auth/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const MIMI_SEED_CLIENT_ID: string;
+export declare const MIMI_SEED_CLIENT_SECRET: string;

package/dist/auth/constants.js

@@ -0,0 +1,11 @@
+// Mimi Seed 내장 OAuth 클라이언트
+// 유저가 직접 만들 필요 없음 — `npx -y @yoonion/mimi-seed-mcp mimi-seed-auth`
+// (또는 로컬 dev 중엔 `npm run auth`) 한 줄이면 끝
+// 환경변수 MIMI_SEED_GOOGLE_CLIENT_ID / MIMI_SEED_GOOGLE_CLIENT_SECRET 로 오버라이드 가능
+// (레거시 PRESEED_GOOGLE_CLIENT_ID / PRESEED_GOOGLE_CLIENT_SECRET 도 계속 인식)
+export const MIMI_SEED_CLIENT_ID = process.env.MIMI_SEED_GOOGLE_CLIENT_ID ??
+    process.env.PRESEED_GOOGLE_CLIENT_ID ??
+    '980022244769-b6qugfe22pvfadg6ccaq699pc7nuju70.apps.googleusercontent.com';
+export const MIMI_SEED_CLIENT_SECRET = process.env.MIMI_SEED_GOOGLE_CLIENT_SECRET ??
+    process.env.PRESEED_GOOGLE_CLIENT_SECRET ??
+    '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';

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

@@ -0,0 +1,22 @@
+export interface StoredTokens {
+    access_token: string;
+    refresh_token: string;
+    token_type: string;
+    expiry_date: number;
+}
+export declare function getStoredCredentials(): {
+    clientId: string;
+    clientSecret: string;
+} | null;
+export declare function saveCredentials(clientId: string, clientSecret: string): void;
+export declare function getStoredTokens(): StoredTokens | null;
+export declare function createOAuth2Client(clientId: string, clientSecret: string): import("google-auth-library").OAuth2Client;
+/**
+ * Get authenticated OAuth2 client.
+ * Returns null if not authenticated yet.
+ */
+export declare function getAuthenticatedClient(): ReturnType<typeof createOAuth2Client> | null;
+/**
+ * Interactive login — opens browser, waits for callback
+ */
+export declare function login(clientId: string, clientSecret: string): Promise<StoredTokens>;