egovframe-scaffold-mcp 0.7.0 → 0.8.0

package/README.md

@@ -23,6 +23,7 @@ Claude, VS Code(Copilot), Cursor 등 MCP를 지원하는 AI 도구에서 **대
 | `remove_egovframe_components` | 설치 매니페스트 기반 컴포넌트 제거 — 의존 컴포넌트 보호, `dryRun` 미리보기 |
 | `validate_egovframe_project` | 조립 프로젝트 무결성 진단 — 파일 존재·DbType↔DB 스크립트 일치 |
 | `get_egovframe_guide` | 컴포넌트의 공식 가이드 문서 조회 (egovframe-docs, 45종 매핑) |
+| `add_ai_components` | **(신규, M1 미리보기)** 공식 [egovframe-ai-rag](https://github.com/eGovFramework/egovframe-ai-rag) 샘플 기반 AI RAG 챗봇 조립 — Spring AI(Redis Stack)·LangChain4j(PGVector) 스택 선택, 파일 복사 계획·pom 의존성 diff·호환성 진단 (설계: [docs/design-ai-components.md](docs/design-ai-components.md)) |
 
 ### create_egovframe_project 파라미터
 
@@ -106,11 +107,13 @@ Claude Desktop / Claude Code 설정 예 (`mcpServers`):
 
 1. 공통컴포넌트 선택 설치 — **M3 완료(v0.4.0)**: 저장소 스캔 기반 카탈로그 자동 생성(`npm run generate:catalog`, 68종) + 조립 파이프라인. 남은 항목: 컴포넌트별 테이블 선별 DDL, 이름·의존성 큐레이션 확대(`catalog/overrides.json` 기여 환영) (설계: [docs/design-components-parameter.md](docs/design-components-parameter.md))
 2. 실행환경 보일러플레이트(egovframe-msa 등) 템플릿 추가
-3. 검증 도구(`validate_egovframe_config`) 등 후속 도구
+3. AI 컴포넌트 조립(`add_ai_components`) — **M1 완료(v0.8.0)**: AI 카탈로그(egovframe-ai-rag 스캔 자동 생성) + dryRun 미리보기(의존성 diff·호환성 게이트). M2(v0.9.0): 실조립(복사+pom 병합+설정 프로필화) (설계: [docs/design-ai-components.md](docs/design-ai-components.md))
 4. 검증 후 eGovFramework 조직 공식 저장소 편입 제안
 
 ## 변경 이력
 
+- **0.8.0** — AI 컴포넌트 조립 M1: `add_ai_components` dryRun 미리보기(파일 복사 계획·pom 의존성 diff·부모 POM 호환성 게이트·스택 상호 배타 검사), AI 카탈로그(`catalog/ai-components.json`, egovframe-ai-rag 모듈 스캔 자동 생성 `npm run generate:ai-catalog`), `list_egovframe_components`에 AI 컴포넌트 노출, 오프라인 테스트(`npm run test:ai`) 추가.
+
 - **0.7.0** — `get_egovframe_guide`: 컴포넌트 id로 표준프레임워크 공식 가이드 문서(egovframe-docs)를 조회. 카탈로그에 문서 매핑 자동 생성(`--docs`, 지배적 패키지 참조 기준 45종) 추가. 한글명 큐레이션 12→27종.
 
 - **0.6.0** — 컴포넌트별 테이블 선별 DDL(M4): 카탈로그에 매퍼 기반 참조 테이블 자동 추출(48/68종), `database` 지정 시 통합 스크립트에서 해당 컴포넌트 구문만 추출해 `ddl|dml/<컴포넌트id>.sql` 생성(테이블 미상 컴포넌트는 통합본 폴백), 매니페스트에 컴포넌트별 스크립트 귀속(제거 시 함께 정리).

package/catalog/ai-components.json

@@ -0,0 +1,369 @@
+{
+  "schemaVersion": 1,
+  "source": {
+    "repo": "eGovFramework/egovframe-ai-rag",
+    "branch": "main",
+    "surveyedAt": "2026-07-12"
+  },
+  "note": "add_ai_components용 카탈로그 — 조립 대상은 egovframe-boot-starter-parent 기반 Boot 프로젝트. 두 스택은 같은 패키지(com.example.chat)·UI 경로를 사용하므로 상호 배타(conflictsWith).",
+  "components": [
+    {
+      "id": "ai-rag-spring-ai",
+      "stack": "spring-ai",
+      "kind": "ai",
+      "name": "AI RAG 챗봇 (Spring AI + Redis Stack)",
+      "description": "Spring AI 기반 RAG 질의응답 — 문서 업로드(PDF·DOCX·HWP·HWPX·MD)→임베딩→Redis Stack 하이브리드 검색→Ollama LLM 응답, 채팅 UI 포함",
+      "modulePath": "spring-ai-rag-redis-stack",
+      "vectorStore": "Redis Stack",
+      "conflictsWith": [
+        "ai-rag-langchain4j"
+      ],
+      "requires": {
+        "java": "17",
+        "parent": "egovframe-boot-starter-parent:5.0.0"
+      },
+      "copyGroups": {
+        "source": {
+          "paths": [
+            "src/main/java/com/example/chat/"
+          ],
+          "files": 45
+        },
+        "config": {
+          "paths": [
+            "src/main/resources/application.yml -> src/main/resources/application-ai.yml",
+            "src/main/resources/log4j2-spring.xml -> src/main/resources/log4j2-ai.xml"
+          ],
+          "files": 2
+        },
+        "ui": {
+          "paths": [
+            "src/main/resources/templates/",
+            "src/main/resources/static/"
+          ],
+          "files": 3
+        },
+        "infra": {
+          "paths": [
+            "docker-compose.yml -> docker-compose.ai.yml",
+            "Dockerfile -> Dockerfile.ai",
+            "k8s/ -> k8s/ai/"
+          ],
+          "files": 6
+        },
+        "tests": {
+          "paths": [
+            "src/test/"
+          ],
+          "files": 15
+        }
+      },
+      "approxFiles": 56,
+      "mavenDependencies": [
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-actuator",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-client-chat"
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-rag"
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-starter-vector-store-redis"
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-starter-model-ollama"
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-advisors-vector-store"
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-starter-model-transformers"
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-pdf-document-reader"
+        },
+        {
+          "groupId": "org.springframework.ai",
+          "artifactId": "spring-ai-markdown-document-reader"
+        },
+        {
+          "groupId": "org.egovframe.rte",
+          "artifactId": "egovframe-rte-fdl-excel"
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-thymeleaf",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-web",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "org.egovframe.rte",
+          "artifactId": "egovframe-rte-ptl-mvc",
+          "exclusions": [
+            {
+              "groupId": "org.apache.commons",
+              "artifactId": "commons-lang3"
+            }
+          ]
+        },
+        {
+          "groupId": "kr.dogfoot",
+          "artifactId": "hwplib",
+          "version": "1.1.9"
+        },
+        {
+          "groupId": "org.projectlombok",
+          "artifactId": "lombok",
+          "optional": true
+        },
+        {
+          "groupId": "kr.dogfoot",
+          "artifactId": "hwpxlib",
+          "version": "1.0.8"
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-test",
+          "scope": "test"
+        }
+      ],
+      "mavenProperties": {},
+      "prerequisites": [
+        "ollama>=0.17.1",
+        "onnx-embedding-model",
+        "docker"
+      ]
+    },
+    {
+      "id": "ai-rag-langchain4j",
+      "stack": "langchain4j",
+      "kind": "ai",
+      "name": "AI RAG 챗봇 (LangChain4j + PGVector)",
+      "description": "LangChain4j 기반 RAG 질의응답 — 문서 업로드(PDF·DOCX·HWP·HWPX·MD)→임베딩→PostgreSQL(PGVector) 하이브리드 검색→Ollama LLM 응답, 채팅 UI 포함",
+      "modulePath": "langchain4j-ai-rag-postgre",
+      "vectorStore": "PostgreSQL (PGVector)",
+      "conflictsWith": [
+        "ai-rag-spring-ai"
+      ],
+      "requires": {
+        "java": "17",
+        "parent": "egovframe-boot-starter-parent:5.0.0"
+      },
+      "copyGroups": {
+        "source": {
+          "paths": [
+            "src/main/java/com/example/chat/"
+          ],
+          "files": 49
+        },
+        "config": {
+          "paths": [
+            "src/main/resources/application.yml -> src/main/resources/application-ai.yml",
+            "src/main/resources/log4j2-spring.xml -> src/main/resources/log4j2-ai.xml"
+          ],
+          "files": 2
+        },
+        "ui": {
+          "paths": [
+            "src/main/resources/templates/",
+            "src/main/resources/static/"
+          ],
+          "files": 3
+        },
+        "infra": {
+          "paths": [
+            "docker-compose.yml -> docker-compose.ai.yml",
+            "Dockerfile -> Dockerfile.ai",
+            "k8s/ -> k8s/ai/",
+            "init-scripts/ -> init-scripts/ai/"
+          ],
+          "files": 9
+        },
+        "tests": {
+          "paths": [
+            "src/test/"
+          ],
+          "files": 14
+        }
+      },
+      "approxFiles": 63,
+      "mavenDependencies": [
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-actuator",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "dev.langchain4j",
+          "artifactId": "langchain4j"
+        },
+        {
+          "groupId": "dev.langchain4j",
+          "artifactId": "langchain4j-ollama"
+        },
+        {
+          "groupId": "dev.langchain4j",
+          "artifactId": "langchain4j-pgvector"
+        },
+        {
+          "groupId": "dev.langchain4j",
+          "artifactId": "langchain4j-embeddings"
+        },
+        {
+          "groupId": "dev.langchain4j",
+          "artifactId": "langchain4j-document-parser-apache-pdfbox"
+        },
+        {
+          "groupId": "org.egovframe.rte",
+          "artifactId": "egovframe-rte-fdl-excel",
+          "exclusions": [
+            {
+              "groupId": "org.apache.commons",
+              "artifactId": "commons-lang3"
+            }
+          ]
+        },
+        {
+          "groupId": "dev.langchain4j",
+          "artifactId": "langchain4j-reactor"
+        },
+        {
+          "groupId": "com.h2database",
+          "artifactId": "h2",
+          "version": "2.2.224",
+          "scope": "test"
+        },
+        {
+          "groupId": "org.postgresql",
+          "artifactId": "postgresql",
+          "scope": "runtime"
+        },
+        {
+          "groupId": "org.testcontainers",
+          "artifactId": "postgresql",
+          "scope": "test"
+        },
+        {
+          "groupId": "org.testcontainers",
+          "artifactId": "junit-jupiter",
+          "scope": "test"
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-thymeleaf",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-web",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-webflux",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-data-jpa",
+          "exclusions": [
+            {
+              "groupId": "org.springframework.boot",
+              "artifactId": "spring-boot-starter-logging"
+            }
+          ]
+        },
+        {
+          "groupId": "org.egovframe.rte",
+          "artifactId": "egovframe-rte-ptl-mvc",
+          "exclusions": [
+            {
+              "groupId": "org.apache.commons",
+              "artifactId": "commons-lang3"
+            }
+          ]
+        },
+        {
+          "groupId": "commons-codec",
+          "artifactId": "commons-codec"
+        },
+        {
+          "groupId": "kr.dogfoot",
+          "artifactId": "hwplib",
+          "version": "1.1.9"
+        },
+        {
+          "groupId": "kr.dogfoot",
+          "artifactId": "hwpxlib",
+          "version": "1.0.5"
+        },
+        {
+          "groupId": "org.projectlombok",
+          "artifactId": "lombok",
+          "optional": true
+        },
+        {
+          "groupId": "org.springframework.boot",
+          "artifactId": "spring-boot-starter-test",
+          "scope": "test"
+        }
+      ],
+      "mavenProperties": {},
+      "prerequisites": [
+        "ollama>=0.17.1",
+        "onnx-embedding-model",
+        "docker"
+      ]
+    }
+  ]
+}

package/dist/index.js

@@ -584,10 +584,117 @@ export async function getGuide(componentId, docIndex = 0) {
     return { componentId, docs, selected: sel, content, truncated };
 }
 /* ------------------------------------------------------------------ */
+/* AI 컴포넌트 조립 (M1: dryRun 미리보기) — 설계: docs/design-ai-components.md */
+/* 소스: eGovFramework/egovframe-ai-rag (Spring AI·LangChain4j RAG 샘플)   */
+/* ------------------------------------------------------------------ */
+export const AI_STACKS = ["spring-ai", "langchain4j"];
+const AI_CATALOG_URL = new URL("../catalog/ai-components.json", import.meta.url);
+/** AI 카탈로그 로드 + 무결성 검증 (id 중복, conflictsWith 대상 존재, stack 유일) */
+export function loadAiCatalog() {
+    const catalog = JSON.parse(fs.readFileSync(AI_CATALOG_URL, "utf-8"));
+    const ids = new Set();
+    const stacks = new Set();
+    for (const c of catalog.components) {
+        if (ids.has(c.id))
+            throw new Error(`AI 카탈로그 오류: 중복 id '${c.id}'`);
+        ids.add(c.id);
+        if (stacks.has(c.stack))
+            throw new Error(`AI 카탈로그 오류: 중복 stack '${c.stack}'`);
+        stacks.add(c.stack);
+    }
+    for (const c of catalog.components)
+        for (const x of c.conflictsWith)
+            if (!ids.has(x))
+                throw new Error(`AI 카탈로그 오류: '${c.id}'의 conflictsWith '${x}'가 카탈로그에 없습니다`);
+    return catalog;
+}
+/**
+ * AI 컴포넌트 조립 계획 (M1) — dryRun 미리보기 전용.
+ * 파일 복사 계획·pom 의존성 diff·호환성 게이트 결과를 네트워크 없이 반환한다.
+ * 실제 조립(파일 복사 + pom 병합 + 설정 프로필화)은 M2(v0.9.0)에서 제공한다.
+ */
+export async function planAiComponents(opts) {
+    if (opts.dryRun === false)
+        throw new Error("add_ai_components는 현재 dryRun 미리보기만 지원합니다 — 실제 조립은 M2(v0.9.0)에서 제공됩니다 (설계: docs/design-ai-components.md)");
+    if (!AI_STACKS.includes(opts.stack))
+        throw new Error(`stack은 ${AI_STACKS.join("|")} 중 하나여야 합니다: ${String(opts.stack)}`);
+    const catalog = loadAiCatalog();
+    const comp = catalog.components.find((c) => c.stack === opts.stack);
+    const projectDir = path.resolve(opts.projectDir);
+    // 매니페스트 게이트: 동일/배타 스택 설치 여부
+    const manifest = readManifest(projectDir);
+    if (manifest) {
+        if (manifest.components[comp.id])
+            throw new Error(`'${comp.id}'가 이미 설치되어 있습니다 (매니페스트 기준)`);
+        for (const x of comp.conflictsWith)
+            if (manifest.components[x])
+                throw new Error(`상호 배타 컴포넌트 '${x}'가 이미 설치되어 있습니다 — 두 AI 스택은 같은 패키지(com.example.chat)·UI 경로를 사용합니다. 먼저 remove_egovframe_components로 제거하세요`);
+    }
+    // 호환성 게이트: 부모 POM 좌표 확인 + 의존성 diff
+    const warnings = [];
+    const pomPath = path.join(projectDir, "pom.xml");
+    const pomFound = fs.existsSync(pomPath);
+    let parentFound = null;
+    let parentOk = null;
+    const toAdd = [];
+    const alreadyPresent = [];
+    if (pomFound) {
+        const pom = fs.readFileSync(pomPath, "utf-8");
+        const pm = pom.match(/<parent>[\s\S]*?<\/parent>/);
+        if (pm) {
+            const a = pm[0].match(/<artifactId>([^<]*)<\/artifactId>/)?.[1]?.trim();
+            const v = pm[0].match(/<version>([^<]*)<\/version>/)?.[1]?.trim();
+            parentFound = a ? `${a}:${v ?? "?"}` : null;
+        }
+        const [reqA, reqV] = comp.requires.parent.split(":");
+        parentOk = parentFound !== null && parentFound.startsWith(`${reqA}:`);
+        if (!parentOk)
+            warnings.push(`부모 POM이 '${comp.requires.parent}'가 아닙니다(발견: ${parentFound ?? "없음"}) — Boot 기반 템플릿(simple-backend)에서 지원합니다`);
+        else if (parentFound !== comp.requires.parent)
+            warnings.push(`부모 POM 버전이 다릅니다(요구 ${reqV}, 발견 ${parentFound}) — BOM 관리 버전 차이를 확인하세요`);
+        for (const d of comp.mavenDependencies) {
+            const coord = `${d.groupId}:${d.artifactId}${d.version ? ":" + d.version : ""}${d.scope ? " (" + d.scope + ")" : ""}`;
+            if (pom.includes(`<artifactId>${d.artifactId}</artifactId>`))
+                alreadyPresent.push(coord);
+            else
+                toAdd.push(coord);
+        }
+    }
+    else {
+        warnings.push("pom.xml이 없습니다 — Boot 백엔드 프로젝트 루트 경로인지 확인하세요");
+    }
+    // 복사 계획: source·config 필수, ui/infra/tests는 옵션
+    const groups = ["source", "config"];
+    if (opts.includeUi !== false)
+        groups.push("ui");
+    if (opts.includeInfra !== false)
+        groups.push("infra");
+    if (opts.includeTests === true)
+        groups.push("tests");
+    const copyPlan = groups.map((g) => ({ group: g, files: comp.copyGroups[g].files, paths: comp.copyGroups[g].paths }));
+    const totalFiles = copyPlan.reduce((n, g) => n + g.files, 0);
+    return {
+        projectDir,
+        component: { id: comp.id, name: comp.name, vectorStore: comp.vectorStore },
+        compatibility: { pomFound, required: comp.requires.parent, parentFound, parentOk, warnings },
+        dependencyChanges: { toAdd, alreadyPresent },
+        copyPlan,
+        totalFiles,
+        prerequisites: comp.prerequisites,
+        nextSteps: [
+            "M1은 미리보기 전용입니다 — 실제 조립은 M2(v0.9.0)에서 제공됩니다",
+            "Ollama(>=0.17.1) 설치 및 LLM 모델 준비 (폐쇄망 절차는 egovframe-ai-rag README 참조)",
+            "ONNX 임베딩 모델 익스포트·배치",
+            "docker compose로 벡터 저장소(Redis Stack 또는 PGVector) 기동",
+        ],
+        dryRun: true,
+    };
+}
+/* ------------------------------------------------------------------ */
 /* MCP 서버                                                             */
 /* ------------------------------------------------------------------ */
 export function buildServer() {
-    const server = new McpServer({ name: "egovframe-scaffold-mcp", version: "0.7.0" });
+    const server = new McpServer({ name: "egovframe-scaffold-mcp", version: "0.8.0" });
     server.tool("list_egovframe_templates", "사용 가능한 전자정부 표준프레임워크 프로젝트 템플릿 목록을 반환합니다.", {}, async () => ({
         content: [
             {
@@ -625,6 +732,17 @@ export function buildServer() {
     });
     server.tool("list_egovframe_components", "선택 설치를 지원하는 공통컴포넌트 카탈로그를 반환합니다 (저장소 스캔으로 자동 생성, scripts/generate-catalog.mjs).", {}, async () => {
         const catalog = loadCatalog();
+        let ai;
+        try {
+            const aiCat = loadAiCatalog();
+            ai = {
+                source: aiCat.source,
+                components: aiCat.components.map((c) => ({
+                    id: c.id, stack: c.stack, name: c.name, description: c.description, approxFiles: c.approxFiles,
+                })),
+            };
+        }
+        catch { /* AI 카탈로그가 없어도 기본 목록은 동작 */ }
         return {
             content: [
                 {
@@ -632,6 +750,7 @@ export function buildServer() {
                     text: JSON.stringify({
                         source: catalog.source,
                         sqlNote: catalog.sqlNote,
+                        aiComponents: ai,
                         components: catalog.components.map((c) => ({
                             id: c.id, name: c.name, category: c.category,
                             description: c.description, dependsOn: c.dependsOn, approxFiles: c.approxFiles,
@@ -726,6 +845,36 @@ export function buildServer() {
         ].filter((l, i) => l !== "" || i >= 4).join("\n");
         return { content: [{ type: "text", text: head + r.content }] };
     });
+    server.tool("add_ai_components", "공식 egovframe-ai-rag 샘플 기반 AI RAG 챗봇(문서 업로드→임베딩→하이브리드 검색→LLM 응답)을 기존 Boot 프로젝트에 조립합니다. " +
+        "현재 M1은 dryRun 미리보기 전용 — 파일 복사 계획·pom 의존성 diff·호환성 진단을 반환합니다 (설계: docs/design-ai-components.md).", {
+        projectDir: z.string().describe("대상 프로젝트 디렉터리(절대경로 권장). egovframe-boot-starter-parent 기반 Boot 프로젝트"),
+        stack: z.enum(AI_STACKS).describe("AI 스택: spring-ai(Redis Stack) | langchain4j(PGVector). 상호 배타"),
+        includeInfra: z.boolean().default(true).describe("docker-compose·Dockerfile·k8s 복사 계획 포함"),
+        includeUi: z.boolean().default(true).describe("채팅 UI(chat.html·static) 복사 계획 포함"),
+        includeTests: z.boolean().default(false).describe("샘플 테스트 복사 계획 포함"),
+        dryRun: z.boolean().default(true).describe("M1에서는 true만 지원 (실조립은 M2/v0.9.0)"),
+    }, async (args) => {
+        const r = await planAiComponents(args);
+        const c = r.compatibility;
+        const text = [
+            `🔍 AI 컴포넌트 조립 미리보기(dryRun): ${r.projectDir}`,
+            `- 컴포넌트: ${r.component.id} — ${r.component.name}`,
+            `- 호환성: 부모 POM ${c.parentOk === true ? "일치" : c.parentOk === false ? "불일치" : "미확인"}` +
+                ` (요구 ${c.required}${c.parentFound ? ", 발견 " + c.parentFound : ""})`,
+            ...(c.warnings.length ? c.warnings.map((w) => `  ! ${w}`) : []),
+            `- pom 의존성: 추가 예정 ${r.dependencyChanges.toAdd.length}건` +
+                (r.dependencyChanges.alreadyPresent.length ? `, 이미 존재 ${r.dependencyChanges.alreadyPresent.length}건` : ""),
+            ...r.dependencyChanges.toAdd.slice(0, 8).map((d) => `  + ${d}`),
+            ...(r.dependencyChanges.toAdd.length > 8 ? [`  + … 외 ${r.dependencyChanges.toAdd.length - 8}건`] : []),
+            `- 복사 계획 (총 ${r.totalFiles}개 파일):`,
+            ...r.copyPlan.map((g) => `  · ${g.group}: ${g.files}개 — ${g.paths.join(", ")}`),
+            `- 실행 전제: ${r.prerequisites.join(", ")}`,
+            ``,
+            `다음 단계:`,
+            ...r.nextSteps.map((s, i) => `  ${i + 1}. ${s}`),
+        ].join("\n");
+        return { content: [{ type: "text", text }] };
+    });
     return server;
 }
 const isMain = process.argv[1] && import.meta.url.endsWith(path.basename(process.argv[1]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "egovframe-scaffold-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "전자정부 표준프레임워크(eGovFrame) 프로젝트 스캐폴딩·공통컴포넌트 조립 MCP 서버 — create/search/add/validate/remove",
   "license": "Apache-2.0",
   "type": "module",
@@ -15,7 +15,9 @@
     "test:catalog": "node test/catalog.mjs",
     "test:components": "node test/components.mjs",
     "generate:catalog": "node scripts/generate-catalog.mjs",
-    "prepublishOnly": "npm run build && npm run test:catalog"
+    "prepublishOnly": "npm run build && npm run test:catalog && npm run test:ai",
+    "test:ai": "node test/ai.mjs",
+    "generate:ai-catalog": "node scripts/generate-ai-catalog.mjs"
   },
   "engines": {
     "node": ">=18"