@yoonion/mimi-seed-mcp 0.4.0 → 0.6.0

package/README.md

@@ -62,24 +62,30 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 ---
 
-## 제공 도구 (110+개)
+## 제공 도구 (147개 · 17개 영역)
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
-| App Store Connect | 30 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
-| Google Play | 26 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
-| Firebase | 17 | `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` / `firebase_enable_service` |
+| App Store Connect | 31 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
+| Google Play | 28 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
+| Firebase | 19 | `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` / `firebase_enable_service` |
 | 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 (크리덴셜) | 6 | `jenkins_create_credential` / `jenkins_upload_keystore` / `jenkins_save_config` |
+| GA4 | 6 | `ga4_create_property` / `ga4_create_data_stream` / `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` |
 | Google Cloud IAM | 5 | `iam_create_service_account` / `iam_create_key` / `iam_add_iam_policy_binding` |
 | BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
 | 점검 / 위험 | 4 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `screenshot_validate` / `release_status` |
 | Instagram | 4 | `instagram_post_image` / `instagram_post_carousel` / `instagram_save_config` |
+| Android 서명 | 3 | `android_signing_setup` / `android_generate_keystore` / `jenkins_upload_playstore_sa` |
+| 인증 | 3 | `mimi_seed_status` / `mimi_seed_auth_start` / `mimi_seed_auth_status` |
 | AI (Claude) | 2 | `generate_release_notes_from_commits` / `generate_review_reply` |
-| 인증 | 2 | `mimi_seed_auth_start` / `mimi_seed_auth_status` |
 
 > 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `playstore_create_subscription` · `appstore_create_inapp_purchase` 등 (`@onesub/providers` 위임).
+> 전체 카탈로그(항상 최신): [`docs/domain/tool-catalog.md`](../../docs/domain/tool-catalog.md)
 
 ---
 

package/dist/jenkins/credentials.js

@@ -1,8 +1,6 @@
+import { authHeaders, getCrumb } from './http.js';
 const FILE_CLASS = 'org.jenkinsci.plugins.plaincredentials.impl.FileCredentialsImpl';
 const TEXT_CLASS = 'org.jenkinsci.plugins.plaincredentials.impl.StringCredentialsImpl';
-function basicAuth(username, token) {
-    return 'Basic ' + Buffer.from(`${username}:${token}`).toString('base64');
-}
 // 도메인(_ = 전역) 레벨 — 목록 조회 / createCredentials 의 베이스
 function storeBase(url) {
     return `${url.replace(/\/$/, '')}/credentials/store/system/domain/_`;
@@ -11,36 +9,15 @@ function storeBase(url) {
 function credentialBase(url, id) {
     return `${storeBase(url)}/credential/${encodeURIComponent(id)}`;
 }
-/**
- * CSRF crumb (best-effort). crumb issuer 비활성이거나 API 토큰으로 면제되면 빈 객체.
- * 구버전 Jenkins / 비밀번호 인증 환경에서 POST 403 방지.
- */
-async function getCrumb(cfg) {
-    try {
-        const res = await fetch(`${cfg.url.replace(/\/$/, '')}/crumbIssuer/api/json`, {
-            headers: { Authorization: basicAuth(cfg.username, cfg.token) },
-        });
-        if (!res.ok)
-            return {};
-        const data = (await res.json());
-        if (data.crumbRequestField && data.crumb) {
-            return { [data.crumbRequestField]: data.crumb };
-        }
-        return {};
-    }
-    catch {
-        return {};
-    }
-}
 async function credentialExists(cfg, id) {
     const res = await fetch(`${credentialBase(cfg.url, id)}/api/json`, {
-        headers: { Authorization: basicAuth(cfg.username, cfg.token) },
+        headers: authHeaders(cfg),
     });
     return res.ok;
 }
 export async function listCredentials(cfg) {
     const res = await fetch(`${storeBase(cfg.url)}/api/json?depth=1`, {
-        headers: { Authorization: basicAuth(cfg.username, cfg.token) },
+        headers: authHeaders(cfg),
     });
     if (!res.ok)
         throw new Error(`Jenkins credentials 조회 실패 (${res.status})`);
@@ -70,7 +47,7 @@ export async function upsertSecretText(cfg, id, secret, description = '') {
     const res = await fetch(endpoint, {
         method: 'POST',
         headers: {
-            Authorization: basicAuth(cfg.username, cfg.token),
+            ...authHeaders(cfg),
             'Content-Type': 'application/x-www-form-urlencoded',
             ...crumb,
         },
@@ -109,7 +86,7 @@ export async function upsertSecretFile(cfg, id, fileBase64, fileName, descriptio
     const res = await fetch(endpoint, {
         method: 'POST',
         headers: {
-            Authorization: basicAuth(cfg.username, cfg.token),
+            ...authHeaders(cfg),
             ...crumb,
         },
         body: form,
@@ -124,7 +101,7 @@ export async function deleteCredential(cfg, id) {
     const res = await fetch(`${credentialBase(cfg.url, id)}/doDelete`, {
         method: 'POST',
         headers: {
-            Authorization: basicAuth(cfg.username, cfg.token),
+            ...authHeaders(cfg),
             ...crumb,
         },
     });

package/dist/jenkins/http.d.ts

@@ -0,0 +1,22 @@
+import type { JenkinsConfig } from './config.js';
+export declare function basicAuth(username: string, token: string): string;
+export declare function baseUrl(cfg: JenkinsConfig): string;
+export declare function authHeaders(cfg: JenkinsConfig): Record<string, string>;
+/**
+ * CSRF crumb (best-effort). crumb issuer 비활성이거나 API 토큰으로 면제되면 빈 객체.
+ * 구버전 Jenkins / 비밀번호 인증 환경에서 POST 403 방지.
+ */
+export declare function getCrumb(cfg: JenkinsConfig): Promise<Record<string, string>>;
+/**
+ * 잡 경로를 Jenkins URL 로 바꾼다. 폴더는 `/` 로 구분한다.
+ *   "penguinrun"        -> <base>/job/penguinrun
+ *   "vir-game/client"   -> <base>/job/vir-game/job/client
+ */
+export declare function jobUrl(cfg: JenkinsConfig, jobPath: string): string;
+/**
+ * createItem 은 "부모 컨테이너" 에 POST 하고 leaf 이름을 쿼리로 넘긴다.
+ * 루트 잡이면 부모가 Jenkins 루트, 폴더 안이면 폴더 URL.
+ */
+export declare function createItemUrl(cfg: JenkinsConfig, jobPath: string): string;
+/** 실패 응답의 본문 일부를 붙여 에러를 만든다. Jenkins 는 원인을 본문에만 담는 경우가 많다. */
+export declare function jenkinsError(prefix: string, res: Response): Promise<Error>;

package/dist/jenkins/http.js

@@ -0,0 +1,67 @@
+export function basicAuth(username, token) {
+    return 'Basic ' + Buffer.from(`${username}:${token}`).toString('base64');
+}
+export function baseUrl(cfg) {
+    return cfg.url.replace(/\/$/, '');
+}
+export function authHeaders(cfg) {
+    return { Authorization: basicAuth(cfg.username, cfg.token) };
+}
+/**
+ * CSRF crumb (best-effort). crumb issuer 비활성이거나 API 토큰으로 면제되면 빈 객체.
+ * 구버전 Jenkins / 비밀번호 인증 환경에서 POST 403 방지.
+ */
+export async function getCrumb(cfg) {
+    try {
+        const res = await fetch(`${baseUrl(cfg)}/crumbIssuer/api/json`, {
+            headers: authHeaders(cfg),
+        });
+        if (!res.ok)
+            return {};
+        const data = (await res.json());
+        if (data.crumbRequestField && data.crumb) {
+            return { [data.crumbRequestField]: data.crumb };
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 잡 경로를 Jenkins URL 로 바꾼다. 폴더는 `/` 로 구분한다.
+ *   "penguinrun"        -> <base>/job/penguinrun
+ *   "vir-game/client"   -> <base>/job/vir-game/job/client
+ */
+export function jobUrl(cfg, jobPath) {
+    const segments = jobPath.split('/').filter(Boolean);
+    if (segments.length === 0)
+        throw new Error('잡 이름이 비어 있습니다.');
+    const suffix = segments.map((s) => `job/${encodeURIComponent(s)}`).join('/');
+    return `${baseUrl(cfg)}/${suffix}`;
+}
+/**
+ * createItem 은 "부모 컨테이너" 에 POST 하고 leaf 이름을 쿼리로 넘긴다.
+ * 루트 잡이면 부모가 Jenkins 루트, 폴더 안이면 폴더 URL.
+ */
+export function createItemUrl(cfg, jobPath) {
+    const segments = jobPath.split('/').filter(Boolean);
+    if (segments.length === 0)
+        throw new Error('잡 이름이 비어 있습니다.');
+    const leaf = segments.pop();
+    const parent = segments.length
+        ? `${baseUrl(cfg)}/${segments.map((s) => `job/${encodeURIComponent(s)}`).join('/')}`
+        : baseUrl(cfg);
+    return `${parent}/createItem?name=${encodeURIComponent(leaf)}`;
+}
+/** 실패 응답의 본문 일부를 붙여 에러를 만든다. Jenkins 는 원인을 본문에만 담는 경우가 많다. */
+export async function jenkinsError(prefix, res) {
+    let detail = '';
+    try {
+        detail = (await res.text()).trim().slice(0, 300);
+    }
+    catch {
+        // 본문 없음
+    }
+    return new Error(`${prefix} (${res.status})${detail ? `: ${detail}` : ''}`);
+}

package/dist/jenkins/jobs.d.ts

@@ -0,0 +1,28 @@
+import type { JenkinsConfig } from './config.js';
+export interface JenkinsJobSummary {
+    name: string;
+    url: string;
+    /** 잡 상태 색상. 폴더는 색이 없다. */
+    color?: string;
+}
+/**
+ * 잡 목록. folder 를 주면 그 폴더 안을, 없으면 루트를 조회한다.
+ * 재귀하지 않는다 (한 단계만).
+ */
+export declare function listJobs(cfg: JenkinsConfig, folder?: string): Promise<JenkinsJobSummary[]>;
+/**
+ * 404 만 "없음" 으로 본다. 401/403/500 을 없음으로 삼키면 upsertJob 이 엉뚱하게
+ * 생성 분기를 타므로, 그 경우는 원인을 드러내며 throw 한다.
+ */
+export declare function jobExists(cfg: JenkinsConfig, jobPath: string): Promise<boolean>;
+/** 잡의 config.xml 원문. 백업하거나 수정 전 현재 상태를 확인할 때 쓴다. */
+export declare function getJobConfig(cfg: JenkinsConfig, jobPath: string): Promise<string>;
+/**
+ * 새 잡 생성. 같은 이름이 이미 있으면 Jenkins 가 400 을 준다.
+ * 폴더 안에 만들려면 jobPath 에 "folder/name" 을 넘긴다 (폴더는 미리 존재해야 함).
+ */
+export declare function createJob(cfg: JenkinsConfig, jobPath: string, configXml: string): Promise<void>;
+/** 기존 잡의 config.xml 교체. 잡이 없으면 404. */
+export declare function updateJob(cfg: JenkinsConfig, jobPath: string, configXml: string): Promise<void>;
+/** 있으면 수정, 없으면 생성. Jenkinsfile/job-config.xml 을 레포에서 밀어넣을 때 쓴다. */
+export declare function upsertJob(cfg: JenkinsConfig, jobPath: string, configXml: string): Promise<'created' | 'updated'>;

package/dist/jenkins/jobs.js

@@ -0,0 +1,80 @@
+import { authHeaders, baseUrl, createItemUrl, getCrumb, jenkinsError, jobUrl } from './http.js';
+/**
+ * 잡 목록. folder 를 주면 그 폴더 안을, 없으면 루트를 조회한다.
+ * 재귀하지 않는다 (한 단계만).
+ */
+export async function listJobs(cfg, folder) {
+    const root = folder ? jobUrl(cfg, folder) : baseUrl(cfg);
+    const res = await fetch(`${root}/api/json?tree=jobs[name,url,color]`, {
+        headers: authHeaders(cfg),
+    });
+    if (!res.ok)
+        throw await jenkinsError('Jenkins 잡 목록 조회 실패', res);
+    const data = (await res.json());
+    return data.jobs ?? [];
+}
+/**
+ * 404 만 "없음" 으로 본다. 401/403/500 을 없음으로 삼키면 upsertJob 이 엉뚱하게
+ * 생성 분기를 타므로, 그 경우는 원인을 드러내며 throw 한다.
+ */
+export async function jobExists(cfg, jobPath) {
+    const res = await fetch(`${jobUrl(cfg, jobPath)}/api/json?tree=name`, {
+        headers: authHeaders(cfg),
+    });
+    if (res.ok)
+        return true;
+    if (res.status === 404)
+        return false;
+    throw await jenkinsError(`Jenkins 잡 존재 확인 실패: ${jobPath}`, res);
+}
+/** 잡의 config.xml 원문. 백업하거나 수정 전 현재 상태를 확인할 때 쓴다. */
+export async function getJobConfig(cfg, jobPath) {
+    const res = await fetch(`${jobUrl(cfg, jobPath)}/config.xml`, {
+        headers: authHeaders(cfg),
+    });
+    if (!res.ok)
+        throw await jenkinsError(`Jenkins 잡 config 조회 실패: ${jobPath}`, res);
+    return res.text();
+}
+/**
+ * 새 잡 생성. 같은 이름이 이미 있으면 Jenkins 가 400 을 준다.
+ * 폴더 안에 만들려면 jobPath 에 "folder/name" 을 넘긴다 (폴더는 미리 존재해야 함).
+ */
+export async function createJob(cfg, jobPath, configXml) {
+    const crumb = await getCrumb(cfg);
+    const res = await fetch(createItemUrl(cfg, jobPath), {
+        method: 'POST',
+        headers: {
+            ...authHeaders(cfg),
+            'Content-Type': 'application/xml',
+            ...crumb,
+        },
+        body: configXml,
+    });
+    if (!res.ok)
+        throw await jenkinsError(`Jenkins 잡 생성 실패: ${jobPath}`, res);
+}
+/** 기존 잡의 config.xml 교체. 잡이 없으면 404. */
+export async function updateJob(cfg, jobPath, configXml) {
+    const crumb = await getCrumb(cfg);
+    const res = await fetch(`${jobUrl(cfg, jobPath)}/config.xml`, {
+        method: 'POST',
+        headers: {
+            ...authHeaders(cfg),
+            'Content-Type': 'application/xml',
+            ...crumb,
+        },
+        body: configXml,
+    });
+    if (!res.ok)
+        throw await jenkinsError(`Jenkins 잡 수정 실패: ${jobPath}`, res);
+}
+/** 있으면 수정, 없으면 생성. Jenkinsfile/job-config.xml 을 레포에서 밀어넣을 때 쓴다. */
+export async function upsertJob(cfg, jobPath, configXml) {
+    if (await jobExists(cfg, jobPath)) {
+        await updateJob(cfg, jobPath, configXml);
+        return 'updated';
+    }
+    await createJob(cfg, jobPath, configXml);
+    return 'created';
+}

package/dist/lib/project-manifest.d.ts

@@ -0,0 +1,36 @@
+export declare const MANIFEST_FILENAME = ".mimi-seed.json";
+/** 매니페스트가 인지하는 서비스 id. status 매칭 로직이 이 키를 기준으로 동작한다. */
+export type ManifestServiceId = 'oauth' | 'bigquery' | 'playstore' | 'appstore' | 'jenkins';
+export interface ManifestService {
+    /** 이 프로젝트에서 필수인지. false(선택)면 미설정이어도 ❌ 대신 정보 표기. */
+    required?: boolean;
+    /** 사람이 읽을 한 줄 설명. status 출력에 그대로 표시. */
+    note?: string;
+    projectId?: string;
+    dataset?: string;
+    packageName?: string;
+    keyId?: string;
+    issuerId?: string;
+    url?: string;
+    /** 이 서비스가 워크스페이스 공유 시크릿(provider)으로도 제공되는 경우 그 provider id. */
+    workspaceProvider?: string;
+}
+export interface ProjectManifest {
+    project?: string;
+    displayName?: string;
+    description?: string;
+    services?: Partial<Record<ManifestServiceId, ManifestService>>;
+}
+export interface LoadedManifest {
+    manifest: ProjectManifest;
+    /** 실제로 읽은 파일 절대 경로. */
+    filePath: string;
+}
+/**
+ * startDir 에서 위로 올라가며 첫 번째 `.mimi-seed.json` 을 찾는다.
+ * MCP stdio 서버의 cwd 는 보통 프로젝트 루트지만, 하위 폴더에서 실행돼도 잡히게 상향 탐색한다.
+ * maxDepth 로 홈 디렉터리 밖까지 무한 상승하는 것을 방지.
+ */
+export declare function findProjectManifest(startDir?: string, maxDepth?: number): LoadedManifest | null;
+/** 매니페스트 services 를 [id, service] 배열로. 없으면 빈 배열. */
+export declare function manifestServiceEntries(m: ProjectManifest): Array<[ManifestServiceId, ManifestService]>;

package/dist/lib/project-manifest.js

@@ -0,0 +1,52 @@
+// 프로젝트 매니페스트(.mimi-seed.json) 리더.
+//
+// 프로젝트 루트에 커밋된 `.mimi-seed.json` 이 "이 저장소를 mimi-seed 로 다루려면
+// 어떤 서비스 연결이 필요한가"를 선언한다. mimi_seed_status(MCP)와 mimi-seed doctor(CLI)가
+// 이 파일을 읽어, 범용 9종 스캔 대신 "이 프로젝트에서 너한테 빠진 것 + 정확한 셋업 명령"을 보여준다.
+//
+// 팀 온보딩 목적: 새 팀원이 clone → mimi_seed_status 호출 → 안내 따라가기 만으로
+// 자기 머신에 필요한 자격증명을 채울 수 있게 한다.
+import fs from 'node:fs';
+import path from 'node:path';
+export const MANIFEST_FILENAME = '.mimi-seed.json';
+/**
+ * startDir 에서 위로 올라가며 첫 번째 `.mimi-seed.json` 을 찾는다.
+ * MCP stdio 서버의 cwd 는 보통 프로젝트 루트지만, 하위 폴더에서 실행돼도 잡히게 상향 탐색한다.
+ * maxDepth 로 홈 디렉터리 밖까지 무한 상승하는 것을 방지.
+ */
+export function findProjectManifest(startDir = process.cwd(), maxDepth = 8) {
+    let dir = path.resolve(startDir);
+    for (let i = 0; i <= maxDepth; i++) {
+        const candidate = path.join(dir, MANIFEST_FILENAME);
+        if (fs.existsSync(candidate)) {
+            const parsed = safeParse(candidate);
+            if (parsed)
+                return { manifest: parsed, filePath: candidate };
+            return null; // 파일은 있으나 형식 오류 — 상위로 더 올라가지 않는다(의도 명확).
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break; // 루트 도달
+        dir = parent;
+    }
+    return null;
+}
+function safeParse(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const obj = JSON.parse(raw);
+        if (obj && typeof obj === 'object')
+            return obj;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 매니페스트 services 를 [id, service] 배열로. 없으면 빈 배열. */
+export function manifestServiceEntries(m) {
+    const svc = m.services ?? {};
+    return Object.keys(svc)
+        .filter((k) => svc[k] != null)
+        .map((k) => [k, svc[k]]);
+}

package/dist/registers/auth.js

@@ -7,7 +7,8 @@ import { loadCiConfig } from '../ci/config.js';
 import { loadConfig as loadGoogleAdsConfig } from '../googleads/config.js';
 import { loadFacebookConfig } from '../facebook/config.js';
 import { loadInstagramConfig } from '../instagram/config.js';
-import { getBigQueryServiceAccountKey } from '../auth/bigquery-auth.js';
+import { resolveBigQueryAuth } from '../auth/bigquery-auth.js';
+import { findProjectManifest, manifestServiceEntries, } from '../lib/project-manifest.js';
 /**
  * tokens.json mtime → "Nd Hh ago" 형식 문자열 + 재인증 권고.
  * Google 정책: 7일 미사용 시 미인증 앱 refresh_token revoke 가능.
@@ -34,6 +35,54 @@ function formatLastRefreshHint(lastMs) {
     }
     return { label };
 }
+// 매니페스트 서비스별 셋업 명령. status/doctor 가 "정확한 다음 명령"으로 안내한다.
+const MANIFEST_FIX = {
+    oauth: () => 'mimi_seed_auth_start  (Google 로그인 — Firebase/AdMob/Play/GSC/GA4)',
+    bigquery: () => 'npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth  (서비스 계정 권장)',
+    playstore: (svc) => svc.packageName
+        ? `setup_playstore_connection(packageName="${svc.packageName}")`
+        : 'setup_playstore_connection(packageName=...)',
+    appstore: () => 'npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth',
+    jenkins: () => 'claude mcp add virgm-jenkins -s user  (개인 자격증명 — .mcp.json 금지)',
+};
+/** 서비스별 식별자를 한 줄 detail 로 (예: "ads-coffee / analytics_530080532"). */
+function manifestServiceDetail(id, svc) {
+    const parts = [];
+    if (id === 'bigquery') {
+        if (svc.projectId)
+            parts.push(svc.projectId);
+        if (svc.dataset)
+            parts.push(svc.dataset);
+    }
+    else if (id === 'playstore') {
+        if (svc.packageName)
+            parts.push(svc.packageName);
+    }
+    else if (id === 'appstore') {
+        if (svc.keyId)
+            parts.push(`keyId ${svc.keyId}`);
+    }
+    else if (id === 'jenkins') {
+        if (svc.url)
+            parts.push(svc.url);
+    }
+    return parts.join(' / ');
+}
+/** 매니페스트 한 서비스를 status 라인(들)으로 렌더. 미설정+필수면 명령 힌트를 붙인다. */
+function renderManifestLine(id, svc, connected, required) {
+    const label = id.padEnd(10);
+    const detail = manifestServiceDetail(id, svc);
+    const detailSuffix = detail ? ` (${detail})` : '';
+    if (connected)
+        return `✅ ${label} — 연결됨${detailSuffix}`;
+    if (!required) {
+        const note = svc.note ? ` — ${svc.note}` : '';
+        return `ℹ️  ${label} — (선택)${detailSuffix}${note}`;
+    }
+    const fix = MANIFEST_FIX[id](svc);
+    const noteLine = svc.note ? `\n     ${svc.note}` : '';
+    return `❌ ${label} — 미설정${detailSuffix}\n     → ${fix}${noteLine}`;
+}
 export function registerAuthTools(server) {
     // ── 전체 연결 상태 진단 ────────────────────────────────────────────────────
     server.tool('mimi_seed_status', [
@@ -114,10 +163,14 @@ export function registerAuthTools(server) {
         else {
             lines.push('❌ Instagram         — 미설정 → instagram_save_config  (선택)');
         }
-        // 9. BigQuery
-        const bq = getBigQueryServiceAccountKey();
-        if (bq) {
-            lines.push(`✅ BigQuery          — 서비스 계정 연결됨 (${bq.client_email ?? ''})`);
+        // 9. BigQuery — resolveBigQueryAuth 기준(서비스 계정 우선, OAuth fallback).
+        // 이전엔 SA 파일만 검사해 OAuth fallback 이 살아있어도 ❌ 로 오표기했다.
+        const bqAuth = resolveBigQueryAuth();
+        if (bqAuth?.source === 'service-account') {
+            lines.push(`✅ BigQuery          — 서비스 계정 연결됨 (${bqAuth.clientEmail ?? ''})`);
+        }
+        else if (bqAuth?.source === 'user-oauth') {
+            lines.push('⚠️  BigQuery          — OAuth fallback (Workspace 재인증 정책 시 끊길 수 있음 → 서비스 계정 권장: mimi-seed-bigquery-auth)');
         }
         else {
             lines.push('❌ BigQuery          — 미설정 → npx @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth  (선택)');
@@ -139,6 +192,36 @@ export function registerAuthTools(server) {
         else {
             lines.push('', '✅ 필수 연결 모두 완료. 앱 출시 작업을 시작할 수 있습니다.');
         }
+        // ── 프로젝트 매니페스트(.mimi-seed.json) 기반 요구사항 ────────────────────
+        // 이 저장소가 "무엇을 필요로 하는가"를 선언해두면, 범용 스캔 대신
+        // "이 프로젝트에서 너한테 빠진 것 + 정확한 셋업 명령"을 팀원별로 보여준다.
+        const loaded = findProjectManifest();
+        if (loaded) {
+            const oauthOk = oauthResult.status === 'fresh' || oauthResult.status === 'refreshed';
+            const playstoreCovers = (pkg) => saCount > 0 &&
+                (!pkg || !!saInfo.default || saInfo.perPackage.some((p) => p.packageName === pkg));
+            const state = {
+                oauth: oauthOk,
+                bigquery: !!bqAuth,
+                playstore: playstoreCovers(),
+                appstore: !!asc,
+                jenkins: !!jenkins,
+            };
+            const projName = loaded.manifest.displayName ?? loaded.manifest.project ?? '이 프로젝트';
+            const reqLines = ['', `── ${projName} 요구사항 (.mimi-seed.json) ─────────`];
+            let anyMissing = false;
+            for (const [id, svc] of manifestServiceEntries(loaded.manifest)) {
+                const required = svc.required !== false;
+                const connected = id === 'playstore' ? playstoreCovers(svc.packageName) : state[id];
+                reqLines.push(renderManifestLine(id, svc, connected, required));
+                if (required && !connected)
+                    anyMissing = true;
+            }
+            if (anyMissing) {
+                reqLines.push('', 'ℹ️  팀 공유가 목표라면, 각자 로컬 자격증명을 채우는 대신', '   워크스페이스(https://mimi-seed.pryzm.gg) 초대 → PAT 발급 → 원격 MCP 연결도 가능.');
+            }
+            lines.push(...reqLines);
+        }
         return { content: [{ type: 'text', text: lines.join('\n') }] };
     });
     server.tool('mimi_seed_auth_start', [

package/dist/registers/jenkins.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { loadJenkinsConfig, requireJenkinsConfig, saveJenkinsConfig } from '../jenkins/config.js';
 import * as creds from '../jenkins/credentials.js';
+import * as jobs from '../jenkins/jobs.js';
 export function registerJenkinsTools(server) {
     // ── 0. 상태 확인 (항상 첫 번째로 호출) ─────────────────────────────────────
     server.tool('jenkins_status', [
@@ -42,6 +43,7 @@ export function registerJenkinsTools(server) {
                         '',
                         'jenkins_list_credentials 로 등록된 credential 목록을 확인하거나,',
                         'jenkins_create_credential / jenkins_upload_keystore 로 credential을 추가하세요.',
+                        '잡은 jenkins_list_jobs / jenkins_get_job_config / jenkins_create_job / jenkins_update_job 로 다룹니다.',
                     ].join('\n'),
                 }],
         };
@@ -147,4 +149,77 @@ export function registerJenkinsTools(server) {
                 }],
         };
     });
+    // ── 6. 잡 목록 ─────────────────────────────────────────────────────────────
+    server.tool('jenkins_list_jobs', [
+        'Jenkins 잡 목록을 조회합니다 (이름 / URL / 상태색).',
+        'folder를 주면 그 폴더 안만 조회합니다. 재귀하지 않고 한 단계만 봅니다.',
+        '설정이 없으면 jenkins_status를 먼저 호출하세요.',
+    ].join(' '), {
+        folder: z.string().optional().describe('폴더 경로 (예: vir-game). 생략하면 루트'),
+    }, async ({ folder }) => {
+        const cfg = requireJenkinsConfig();
+        const list = await jobs.listJobs(cfg, folder);
+        if (list.length === 0) {
+            return { content: [{ type: 'text', text: '잡 없음.' }] };
+        }
+        const lines = list.map((j) => `• ${j.name}${j.color ? `  [${j.color}]` : '  [folder]'}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Jenkins jobs (${list.length}개):\n\n${lines.join('\n')}`,
+                }],
+        };
+    });
+    // ── 7. 잡 config.xml 조회 ──────────────────────────────────────────────────
+    server.tool('jenkins_get_job_config', [
+        '잡의 config.xml 원문을 가져옵니다.',
+        '잡을 수정하기 전에 현재 설정을 확인하거나 백업할 때 사용하세요.',
+        '폴더 안의 잡은 "folder/job" 형태로 경로를 넘깁니다.',
+    ].join(' '), {
+        job: z.string().describe('잡 경로 (예: penguinrun, vir-game/client)'),
+    }, async ({ job }) => {
+        const cfg = requireJenkinsConfig();
+        const xml = await jobs.getJobConfig(cfg, job);
+        return { content: [{ type: 'text', text: xml }] };
+    });
+    // ── 8. 잡 생성 ─────────────────────────────────────────────────────────────
+    server.tool('jenkins_create_job', [
+        'config.xml 로 새 Jenkins 잡을 생성합니다 (createItem).',
+        '같은 이름의 잡이 이미 있으면 실패합니다. 덮어쓰려면 overwrite=true 를 주거나 jenkins_update_job 을 쓰세요.',
+        '폴더 안에 만들려면 job 에 "folder/name" 을 넘깁니다 (폴더는 미리 존재해야 합니다).',
+        'config_xml 은 Pipeline job 이면 flow-definition 루트 엘리먼트를 갖는 XML 전문입니다.',
+    ].join(' '), {
+        job: z.string().describe('잡 경로 (예: penguinrun, vir-game/client)'),
+        config_xml: z.string().describe('잡 정의 config.xml 전문'),
+        overwrite: z.boolean().default(false).describe('이미 존재하면 덮어쓸지 여부 (기본 false)'),
+    }, async ({ job, config_xml, overwrite }) => {
+        const cfg = requireJenkinsConfig();
+        if (overwrite) {
+            const result = await jobs.upsertJob(cfg, job, config_xml);
+            return { content: [{ type: 'text', text: `✅ Jenkins 잡 ${result}: \`${job}\`` }] };
+        }
+        if (await jobs.jobExists(cfg, job)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `⚠️ 잡 \`${job}\` 이(가) 이미 존재합니다. jenkins_update_job 을 쓰거나 overwrite=true 로 다시 호출하세요.`,
+                    }],
+            };
+        }
+        await jobs.createJob(cfg, job, config_xml);
+        return { content: [{ type: 'text', text: `✅ Jenkins 잡 created: \`${job}\`` }] };
+    });
+    // ── 9. 잡 수정 ─────────────────────────────────────────────────────────────
+    server.tool('jenkins_update_job', [
+        '기존 Jenkins 잡의 config.xml 을 통째로 교체합니다.',
+        '잡이 없으면 실패합니다 (생성은 jenkins_create_job).',
+        '기존 설정이 사라지므로 jenkins_get_job_config 로 먼저 백업하는 것을 권장합니다.',
+    ].join(' '), {
+        job: z.string().describe('잡 경로 (예: penguinrun, vir-game/client)'),
+        config_xml: z.string().describe('교체할 config.xml 전문'),
+    }, async ({ job, config_xml }) => {
+        const cfg = requireJenkinsConfig();
+        await jobs.updateJob(cfg, job, config_xml);
+        return { content: [{ type: 'text', text: `✅ Jenkins 잡 updated: \`${job}\`` }] };
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {
@@ -50,6 +50,9 @@
   "engines": {
     "node": ">=20"
   },
+  "overrides": {
+    "gaxios": "7.1.5"
+  },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.52.0",
     "@modelcontextprotocol/sdk": "^1.12.1",