@yoonion/mimi-seed-mcp 0.5.0 → 0.6.1

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/google-errors.js

@@ -67,6 +67,15 @@ export function withCause(err, cause) {
     err.cause = cause;
     return err;
 }
+/**
+ * 일부 호출자(예: firebase_create_project)는 "이미 부분적으로 완료된 작업이 있다"는
+ * 사실을 에러 객체에 `partialFailureNote`로 남겨둔다 — 어떤 분기로 친절화되든
+ * (또는 인식 못 해 원본 그대로 통과하든) 그 경고가 사라지지 않도록 항상 앞에 붙인다.
+ */
+function withPartialNote(e, message) {
+    const note = e?.partialFailureNote;
+    return note ? `${note}\n\n${message}` : message;
+}
 /**
  * Firebase / GCP 에러를 친절 메시지로 변환. 신규 사용자가 가장 자주 만나는
  * 'API 미활성화 / 프로젝트 없음 / billing / 권한' 케이스에 다음 행동을 붙인다.
@@ -76,22 +85,28 @@ export function friendlyGoogleError(e) {
     const status = extractHttpStatus(e);
     const reauth = authReauthMessage(text);
     if (reauth)
-        return withCause(new Error(reauth), e);
+        return withCause(new Error(withPartialNote(e, reauth)), e);
     if (/SERVICE_DISABLED|has not been used in project|is disabled|accessNotConfigured/i.test(text)) {
         const url = extractActivationUrl(text);
-        return withCause(new Error([
+        return withCause(new Error(withPartialNote(e, [
             '❌ 필요한 Google API가 비활성화돼 있어요.',
             url ? `→ 활성화: ${url}` : '→ Google Cloud Console에서 해당 API를 활성화한 뒤 다시 시도하세요.',
-        ].join('\n')), e);
+        ].join('\n'))), e);
     }
     if (/BILLING_DISABLED|billing.*(disabled|not enabled|required)/i.test(text)) {
-        return withCause(new Error('❌ 결제(billing)가 비활성화된 프로젝트예요.\n→ Google Cloud Console → 결제 에서 결제 계정을 연결하세요.'), e);
+        return withCause(new Error(withPartialNote(e, '❌ 결제(billing)가 비활성화된 프로젝트예요.\n→ Google Cloud Console → 결제 에서 결제 계정을 연결하세요.')), e);
+    }
+    if (/ALREADY_EXISTS|already exists|already in use/i.test(text)) {
+        return withCause(new Error(withPartialNote(e, '❌ 이미 사용 중인 ID예요 (GCP 프로젝트 ID는 전역에서 유일해야 함).\n→ 다른 projectId로 다시 시도하거나, firebase_get_project 로 소유권을 확인하세요.')), e);
     }
     if (status === 404 || /NOT_FOUND|not found/i.test(text)) {
-        return withCause(new Error('❌ 프로젝트/리소스를 찾을 수 없어요.\n→ firebase_list_projects 로 유효한 projectId를 확인하세요.'), e);
+        return withCause(new Error(withPartialNote(e, '❌ 프로젝트/리소스를 찾을 수 없어요.\n→ firebase_list_projects 로 유효한 projectId를 확인하세요.')), e);
     }
     if (status === 403 || /PERMISSION_DENIED|forbidden|permission/i.test(text)) {
-        return withCause(new Error('❌ 권한 부족 — 이 Google 계정이 해당 프로젝트에 접근 권한이 있는지 확인하세요.'), e);
+        return withCause(new Error(withPartialNote(e, '❌ 권한 부족 — 이 Google 계정이 해당 프로젝트에 접근 권한이 있는지 확인하세요.')), e);
     }
+    const note = e?.partialFailureNote;
+    if (note)
+        return withCause(new Error(`${note}\n\n${text}`), e);
     return e instanceof Error ? e : new Error(text);
 }

package/dist/registers/firebase.js

@@ -37,6 +37,43 @@ export function registerFirebaseTools(server) {
         const project = await firebase.getProject(auth, projectId);
         return { content: [{ type: 'text', text: JSON.stringify(project, null, 2) }] };
     });
+    server.tool('firebase_create_project', [
+        '새 GCP 프로젝트를 만들고 Firebase를 추가한다 (앱 하나당 전용 Firebase 프로젝트 컨벤션 — 기존 프로젝트에',
+        '앱만 추가하려면 firebase_create_android_app/firebase_create_ios_app 사용).',
+        '두 개의 long-running operation(프로젝트 생성 → Firebase 추가)을 순서대로 완료까지 폴링하므로 최악의 경우 2분 정도 걸릴 수 있다.',
+        'projectId는 6-30자, 소문자로 시작, 소문자/숫자/하이픈만 가능(끝에 하이픈 금지).',
+    ].join(' '), {
+        projectId: z
+            .string()
+            .regex(/^[a-z][a-z0-9-]{4,28}[a-z0-9]$/, '소문자로 시작, 소문자/숫자/하이픈 6-30자 (끝에 하이픈 불가)')
+            .describe('새로 만들 GCP/Firebase 프로젝트 ID (예: pryzm-penguinrun)'),
+        displayName: z.string().describe('프로젝트 표시 이름'),
+        parent: z
+            .string()
+            .optional()
+            .describe("조직/폴더 소속이 필요한 계정일 때만: 'organizations/<id>' 또는 'folders/<id>'. 생략 시 계정 기본 정책대로 생성"),
+    }, async ({ projectId, displayName, parent }) => {
+        const auth = await requireAuth();
+        const project = await firebase.createProject(auth, projectId, displayName, { parent });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `✓ Firebase 프로젝트 생성 완료: \`${project.projectId}\``,
+                        '',
+                        `**displayName**: ${project.displayName}`,
+                        `**projectNumber**: ${project.projectNumber}`,
+                        '',
+                        '다음 단계:',
+                        `1. firebase_create_android_app("${project.projectId}", packageName, displayName)`,
+                        `2. firebase_create_ios_app("${project.projectId}", bundleId, displayName)`,
+                        '3. firebase_get_android_config / firebase_get_ios_config 로 설정 파일 다운로드',
+                    ].join('\n'),
+                },
+            ],
+        };
+    });
     server.tool('firebase_list_android_apps', 'Firebase 프로젝트의 Android 앱 목록', { projectId: z.string().describe('Firebase 프로젝트 ID') }, async ({ projectId }) => {
         const auth = await requireAuth();
         const apps = await firebase.listAndroidApps(auth, projectId);

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.5.0",
+  "version": "0.6.1",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {