egovframe-scaffold-mcp 0.5.0 → 0.6.0

package/README.md

@@ -1,6 +1,7 @@
 # egovframe-scaffold-mcp
 
 [![CI](https://github.com/EricSeokgon/egovframe-scaffold-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/EricSeokgon/egovframe-scaffold-mcp/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/egovframe-scaffold-mcp)](https://www.npmjs.com/package/egovframe-scaffold-mcp)
 
 전자정부 표준프레임워크(eGovFrame) 프로젝트 스캐폴딩 **MCP(Model Context Protocol) 서버** — PoC
 
@@ -17,7 +18,7 @@ Claude, VS Code(Copilot), Cursor 등 MCP를 지원하는 AI 도구에서 **대
 | `create_egovframe_project` | 공식 템플릿을 내려받아 projectName(artifactId)·groupId·DB 타입을 적용한 새 프로젝트 생성 |
 | `list_egovframe_templates` | 사용 가능한 공식 템플릿 목록 |
 | `list_egovframe_components` | 선택 설치 가능한 공통컴포넌트 카탈로그 (저장소 스캔 자동 생성, 68종) |
-| `add_egovframe_components` | 공통컴포넌트 선택 조립 — 의존성 포함 소스·매퍼·JSP 복사, DB DDL·DML 스크립트 복사(`database`), 충돌 시 전체 거부, `dryRun` 미리보기 |
+| `add_egovframe_components` | 공통컴포넌트 선택 조립 — 의존성 포함 소스·매퍼·JSP 복사, **컴포넌트별 선별 DDL·DML 생성**(`database`), 충돌 시 전체 거부, `dryRun` 미리보기 |
 | `search_egovframe_components` | 키워드로 컴포넌트 검색 (id·이름·설명, 점수순 상위 10건) |
 | `remove_egovframe_components` | 설치 매니페스트 기반 컴포넌트 제거 — 의존 컴포넌트 보호, `dryRun` 미리보기 |
 | `validate_egovframe_project` | 조립 프로젝트 무결성 진단 — 파일 존재·DbType↔DB 스크립트 일치 |
@@ -36,7 +37,7 @@ Claude, VS Code(Copilot), Cursor 등 MCP를 지원하는 AI 도구에서 **대
 
 ## 설치·사용
 
-npm 배포 후에는 설치 없이 바로 실행할 수 있습니다:
+[npm에 배포되어](https://www.npmjs.com/package/egovframe-scaffold-mcp) 설치 없이 바로 실행할 수 있습니다:
 
 ```json
 {
@@ -109,6 +110,8 @@ Claude Desktop / Claude Code 설정 예 (`mcpServers`):
 
 ## 변경 이력
 
+- **0.6.0** — 컴포넌트별 테이블 선별 DDL(M4): 카탈로그에 매퍼 기반 참조 테이블 자동 추출(48/68종), `database` 지정 시 통합 스크립트에서 해당 컴포넌트 구문만 추출해 `ddl|dml/<컴포넌트id>.sql` 생성(테이블 미상 컴포넌트는 통합본 폴백), 매니페스트에 컴포넌트별 스크립트 귀속(제거 시 함께 정리).
+
 - **0.5.0** — 조립 수명주기 완성: `search_egovframe_components`(키워드 검색), 설치 매니페스트(`.egovframe-components.json`) 기록, `remove_egovframe_components`(의존 보호·dryRun), `validate_egovframe_project`(파일 무결성·DbType↔DDL 일치 진단), 중복 설치 거부.
 
 - **0.4.0** — 공통컴포넌트 선택 설치 M3: 저장소 구조 스캔으로 카탈로그 자동 생성(`scripts/generate-catalog.mjs`), 커버리지 3종 → 68종(2단계 패키지 단위, cmm 하위 통합). 이름·설명·의존성은 `catalog/overrides.json`으로 큐레이션(기본 의존성 휴리스틱: cmm).

package/catalog/components.json

@@ -3,7 +3,7 @@
   "source": {
     "repo": "eGovFramework/egovframe-common-components",
     "branch": "main",
-    "surveyedAt": "2026-07-10"
+    "surveyedAt": "2026-07-11"
   },
   "sqlNote": "DB 스크립트는 script/ddl|dml/<db>/ 의 통합본(com_DDL_<db>.sql 등)으로 제공됩니다. 컴포넌트별 테이블 선별 적용은 로드맵 항목입니다.",
   "generatedBy": "scripts/generate-catalog.mjs",
@@ -19,7 +19,14 @@
         "src/main/webapp/WEB-INF/jsp/egovframework/com/cmm/"
       ],
       "dependsOn": [],
-      "approxFiles": 108
+      "approxFiles": 108,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNAUTHORGROUPINFO",
+        "COMTNFILE",
+        "COMTNFILEDETAIL",
+        "COMTNORGNZTINFO"
+      ]
     },
     {
       "id": "cop.adb",
@@ -34,7 +41,15 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 22
+      "approxFiles": 22,
+      "tables": [
+        "COMTNADBK",
+        "COMTNADBKMANAGE",
+        "COMTNEMPLYRINFO",
+        "COMTNENTRPRSMBER",
+        "COMTNGNRLMBER",
+        "COMTNNCRD"
+      ]
     },
     {
       "id": "bbs",
@@ -49,7 +64,19 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 63
+      "approxFiles": 63,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNBBS",
+        "COMTNBBSMASTER",
+        "COMTNBBSMASTEROPTN",
+        "COMTNBBSUSE",
+        "COMTNBLOG",
+        "COMTNBLOGUSER",
+        "COMTNCOMMENT",
+        "COMTNEMPLYRSCRTYESTBS",
+        "COMTNTMPLATINFO"
+      ]
     },
     {
       "id": "cop.cmt",
@@ -64,7 +91,10 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 15
+      "approxFiles": 15,
+      "tables": [
+        "COMTNCOMMENT"
+      ]
     },
     {
       "id": "cop.cmy",
@@ -79,7 +109,14 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 47
+      "approxFiles": 47,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNBBSMASTER",
+        "COMTNCMMNTY",
+        "COMTNCMMNTYUSER",
+        "COMTNTMPLATINFO"
+      ]
     },
     {
       "id": "cop.com",
@@ -94,7 +131,13 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 26
+      "approxFiles": 26,
+      "tables": [
+        "COMTNCLUB",
+        "COMTNCLUBUSER",
+        "COMTNCMMNTY",
+        "COMTNCMMNTYUSER"
+      ]
     },
     {
       "id": "cop.ems",
@@ -109,7 +152,12 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 45
+      "approxFiles": 45,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTHEMAILDSPTCHMANAGE",
+        "COMTNFILEDETAIL"
+      ]
     },
     {
       "id": "cop.ncm",
@@ -124,7 +172,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 20
+      "approxFiles": 20,
+      "tables": [
+        "COMTNNCRD",
+        "COMTNNCRDUSER"
+      ]
     },
     {
       "id": "cop.scp",
@@ -139,7 +191,10 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 18
+      "approxFiles": 18,
+      "tables": [
+        "COMTNSCRAP"
+      ]
     },
     {
       "id": "cop.sms",
@@ -154,7 +209,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 25
+      "approxFiles": 25,
+      "tables": [
+        "COMTNSMS",
+        "COMTNSMSRECPTN"
+      ]
     },
     {
       "id": "cop.smt",
@@ -169,7 +228,23 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 202
+      "approxFiles": 202,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNDEPTJOB",
+        "COMTNDEPTJOBBX",
+        "COMTNDIARYINFO",
+        "COMTNEMPLYRINFO",
+        "COMTNGNRLMBER",
+        "COMTNLEADERSCHDUL",
+        "COMTNLEADERSCHDULDE",
+        "COMTNLEADERSTTUS",
+        "COMTNMEMOREPRT",
+        "COMTNMEMOTODO",
+        "COMTNORGNZTINFO",
+        "COMTNSCHDULINFO",
+        "COMTNWIKMNTHNGREPRT"
+      ]
     },
     {
       "id": "cop.stf",
@@ -184,7 +259,10 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 12
+      "approxFiles": 12,
+      "tables": [
+        "COMTNSTSFDG"
+      ]
     },
     {
       "id": "cop.tpl",
@@ -199,7 +277,13 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 22
+      "approxFiles": 22,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNBBSMASTER",
+        "COMTNEMPLYRINFO",
+        "COMTNTMPLATINFO"
+      ]
     },
     {
       "id": "dam.app",
@@ -214,7 +298,13 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 17
+      "approxFiles": 17,
+      "tables": [
+        "COMTNDAMKNOIFM",
+        "COMTNDAMMAPKNO",
+        "COMTNDAMMAPTEAM",
+        "COMTNDAMPRO"
+      ]
     },
     {
       "id": "dam.map",
@@ -229,7 +319,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 36
+      "approxFiles": 36,
+      "tables": [
+        "COMTNDAMMAPKNO",
+        "COMTNDAMMAPTEAM"
+      ]
     },
     {
       "id": "dam.mgm",
@@ -244,7 +338,13 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 17
+      "approxFiles": 17,
+      "tables": [
+        "COMTNDAMKNOIFM",
+        "COMTNDAMMAPKNO",
+        "COMTNDAMMAPTEAM",
+        "COMTNEMPLYRSCRTYESTBS"
+      ]
     },
     {
       "id": "dam.per",
@@ -259,7 +359,12 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 18
+      "approxFiles": 18,
+      "tables": [
+        "COMTNDAMKNOIFM",
+        "COMTNDAMMAPKNO",
+        "COMTNDAMMAPTEAM"
+      ]
     },
     {
       "id": "dam.spe",
@@ -274,7 +379,14 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 36
+      "approxFiles": 36,
+      "tables": [
+        "COMTNDAMCALRES",
+        "COMTNDAMMAPKNO",
+        "COMTNDAMMAPTEAM",
+        "COMTNDAMPRO",
+        "COMTNEMPLYRINFO"
+      ]
     },
     {
       "id": "ext.captcha",
@@ -289,7 +401,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 3
+      "approxFiles": 3,
+      "tables": []
     },
     {
       "id": "ext.easybatch",
@@ -304,7 +417,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 2
+      "approxFiles": 2,
+      "tables": []
     },
     {
       "id": "ext.ldapumt",
@@ -319,7 +433,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 14
+      "approxFiles": 14,
+      "tables": []
     },
     {
       "id": "ext.msg",
@@ -334,7 +449,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 15
+      "approxFiles": 15,
+      "tables": []
     },
     {
       "id": "ext.oauth",
@@ -349,7 +465,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 6
+      "approxFiles": 6,
+      "tables": []
     },
     {
       "id": "sec.drm",
@@ -364,7 +481,12 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 16
+      "approxFiles": 16,
+      "tables": [
+        "COMTNEMPLYRINFO",
+        "COMTNEMPLYRSCRTYESTBS",
+        "COMTNORGNZTINFO"
+      ]
     },
     {
       "id": "sec.gmt",
@@ -379,7 +501,10 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 18
+      "approxFiles": 18,
+      "tables": [
+        "COMTNAUTHORGROUPINFO"
+      ]
     },
     {
       "id": "sec.pki",
@@ -394,7 +519,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 2
+      "approxFiles": 2,
+      "tables": []
     },
     {
       "id": "sec.ram",
@@ -409,7 +535,12 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 33
+      "approxFiles": 33,
+      "tables": [
+        "COMTNAUTHORINFO",
+        "COMTNAUTHORROLERELATE",
+        "COMTNROLEINFO"
+      ]
     },
     {
       "id": "sec.rgm",
@@ -424,7 +555,14 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 15
+      "approxFiles": 15,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNEMPLYRINFO",
+        "COMTNEMPLYRSCRTYESTBS",
+        "COMTNENTRPRSMBER",
+        "COMTNGNRLMBER"
+      ]
     },
     {
       "id": "sec.rmt",
@@ -439,7 +577,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 17
+      "approxFiles": 17,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNROLEINFO"
+      ]
     },
     {
       "id": "sec.security",
@@ -454,7 +596,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 1
+      "approxFiles": 1,
+      "tables": []
     },
     {
       "id": "ssi.syi",
@@ -469,7 +612,16 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 82
+      "approxFiles": 82,
+      "tables": [
+        "COMTNCNTCINSTT",
+        "COMTNCNTCMESSAGE",
+        "COMTNCNTCMESSAGEITEM",
+        "COMTNCNTCSERVICE",
+        "COMTNCNTCSYSTEM",
+        "COMTNSYSTEMCNTC",
+        "COMTNTRSMRCVLOG"
+      ]
     },
     {
       "id": "sts.bst",
@@ -484,7 +636,13 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 15
+      "approxFiles": 15,
+      "tables": [
+        "COMTNBBS",
+        "COMTNBBSMASTER",
+        "COMTNTMPLATINFO",
+        "COMTSBBSSUMMARY"
+      ]
     },
     {
       "id": "sts.com",
@@ -499,7 +657,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 1
+      "approxFiles": 1,
+      "tables": []
     },
     {
       "id": "sts.cst",
@@ -514,7 +673,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 14
+      "approxFiles": 14,
+      "tables": [
+        "COMTNLOGINLOG",
+        "COMTSSYSLOGSUMMARY"
+      ]
     },
     {
       "id": "sts.dst",
@@ -529,7 +692,14 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 16
+      "approxFiles": 16,
+      "tables": [
+        "COMTNBBS",
+        "COMTNBBSMASTER",
+        "COMTNDTAUSESTATS",
+        "COMTNFILE",
+        "COMTNFILEDETAIL"
+      ]
     },
     {
       "id": "sts.rst",
@@ -544,7 +714,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 17
+      "approxFiles": 17,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNREPRTSTATS"
+      ]
     },
     {
       "id": "sts.sst",
@@ -559,7 +733,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 14
+      "approxFiles": 14,
+      "tables": [
+        "COMTNPROGRMLIST",
+        "COMTSWEBLOGSUMMARY"
+      ]
     },
     {
       "id": "sts.ust",
@@ -574,7 +752,13 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 15
+      "approxFiles": 15,
+      "tables": [
+        "COMTNEMPLYRINFO",
+        "COMTNENTRPRSMBER",
+        "COMTNGNRLMBER",
+        "COMTSUSERSUMMARY"
+      ]
     },
     {
       "id": "sym.adr",
@@ -589,7 +773,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 2
+      "approxFiles": 2,
+      "tables": []
     },
     {
       "id": "sym.bat",
@@ -604,7 +789,14 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 56
+      "approxFiles": 56,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNBATCHOPERT",
+        "COMTNBATCHRESULT",
+        "COMTNBATCHSCHDUL",
+        "COMTNBATCHSCHDULDFK"
+      ]
     },
     {
       "id": "sym.cal",
@@ -619,7 +811,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 32
+      "approxFiles": 32,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNRESTDE"
+      ]
     },
     {
       "id": "sym.ccm",
@@ -634,7 +830,18 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 143
+      "approxFiles": 143,
+      "tables": [
+        "COMTCADMINISTCODE",
+        "COMTCADMINISTCODERECPTNLOG",
+        "COMTCCMMNCLCODE",
+        "COMTCCMMNCODE",
+        "COMTCCMMNDETAILCODE",
+        "COMTCZIP",
+        "COMTNINSTTCODE",
+        "COMTNINSTTCODERECPTNLOG",
+        "COMTRDNMADRZIP"
+      ]
     },
     {
       "id": "sym.log",
@@ -649,7 +856,20 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 118
+      "approxFiles": 118,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTHSYSHIST",
+        "COMTNLOGINLOG",
+        "COMTNPRIVACYLOG",
+        "COMTNSYSLOG",
+        "COMTNTRSMRCVLOG",
+        "COMTNUSERLOG",
+        "COMTNWEBLOG",
+        "COMTSSYSLOGSUMMARY",
+        "COMTSTRSMRCVLOGSUMMARY",
+        "COMTSWEBLOGSUMMARY"
+      ]
     },
     {
       "id": "sym.mnu",
@@ -664,7 +884,16 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 91
+      "approxFiles": 91,
+      "tables": [
+        "COMTNAUTHORINFO",
+        "COMTNBKMKMENUMANAGERESULT",
+        "COMTNEMPLYRSCRTYESTBS",
+        "COMTNMENUCREATDTLS",
+        "COMTNMENUINFO",
+        "COMTNPROGRMLIST",
+        "COMTNSITEMAP"
+      ]
     },
     {
       "id": "sym.prm",
@@ -679,7 +908,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 36
+      "approxFiles": 36,
+      "tables": [
+        "COMTHPROGRMCHANGEDTLS",
+        "COMTNPROGRMLIST"
+      ]
     },
     {
       "id": "sym.sym",
@@ -694,7 +927,17 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 82
+      "approxFiles": 82,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNBACKUPOPERT",
+        "COMTNBACKUPRESULT",
+        "COMTNBACKUPSCHDULDFK",
+        "COMTNNTWRKINFO",
+        "COMTNSERVEREQPMNINFO",
+        "COMTNSERVEREQPMNRELATE",
+        "COMTNSERVERINFO"
+      ]
     },
     {
       "id": "sym.tbm",
@@ -709,7 +952,11 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 34
+      "approxFiles": 34,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNTROBLINFO"
+      ]
     },
     {
       "id": "uat.sso",
@@ -724,7 +971,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 3
+      "approxFiles": 3,
+      "tables": []
     },
     {
       "id": "uat.uap",
@@ -739,7 +987,10 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 18
+      "approxFiles": 18,
+      "tables": [
+        "COMTNLOGINPOLICY"
+      ]
     },
     {
       "id": "login",
@@ -754,7 +1005,12 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 31
+      "approxFiles": 31,
+      "tables": [
+        "COMTNEMPLYRINFO",
+        "COMTNENTRPRSMBER",
+        "COMTNGNRLMBER"
+      ]
     },
     {
       "id": "uss.cmt",
@@ -769,7 +1025,10 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 15
+      "approxFiles": 15,
+      "tables": [
+        "COMTNCOMMUTE"
+      ]
     },
     {
       "id": "uss.ion",
@@ -784,7 +1043,49 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 567
+      "approxFiles": 567,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNANNVRSRYMANAGE",
+        "COMTNBANNER",
+        "COMTNBNDTCECKMANAGE",
+        "COMTNBNDTDIARY",
+        "COMTNBNDTMANAGE",
+        "COMTNCTSNNMANAGE",
+        "COMTNEMPLYRINFO",
+        "COMTNEVENTATDRN",
+        "COMTNEVENTINFO",
+        "COMTNEVENTMANAGE",
+        "COMTNEXTRLHRINFO",
+        "COMTNFILEDETAIL",
+        "COMTNGNRLMBER",
+        "COMTNINDVDLYRYCMANAGE",
+        "COMTNINFRMLSANCTN",
+        "COMTNINTNETSVC",
+        "COMTNLOGINSCRINIMAGE",
+        "COMTNMAINIMAGE",
+        "COMTNMTGPLACEMANAGE",
+        "COMTNMTGPLACERESVE",
+        "COMTNNEWSINFO",
+        "COMTNNOTE",
+        "COMTNNOTERECPTN",
+        "COMTNNOTETRNSMIT",
+        "COMTNNTFCINFO",
+        "COMTNORGNZTINFO",
+        "COMTNPOPUPMANAGE",
+        "COMTNRECENTSRCHWRD",
+        "COMTNRECENTSRCHWRDMANAGE",
+        "COMTNRECOMENDSITEINFO",
+        "COMTNROUGHMAP",
+        "COMTNRSS",
+        "COMTNRWARDMANAGE",
+        "COMTNSITELIST",
+        "COMTNTWITTER",
+        "COMTNUNITYLINK",
+        "COMTNUSERABSNCE",
+        "COMTNVCATNMANAGE",
+        "COMTNWIKIBKMK"
+      ]
     },
     {
       "id": "uss.mpe",
@@ -799,7 +1100,10 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 17
+      "approxFiles": 17,
+      "tables": [
+        "COMTNINDVDLPGECNTNTS"
+      ]
     },
     {
       "id": "uss.olh",
@@ -814,7 +1118,18 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 116
+      "approxFiles": 116,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNADMINISTRATIONWORD",
+        "COMTNEMPLYRINFO",
+        "COMTNFAQINFO",
+        "COMTNHPCMINFO",
+        "COMTNONLINEMANUAL",
+        "COMTNORGNZTINFO",
+        "COMTNQAINFO",
+        "COMTNWORDDICARYINFO"
+      ]
     },
     {
       "id": "uss.olp",
@@ -829,7 +1144,24 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 206
+      "approxFiles": 206,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTNCNSLTLIST",
+        "COMTNEMPLYRINFO",
+        "COMTNMTGINFO",
+        "COMTNONLINEPOLLIEM",
+        "COMTNONLINEPOLLMANAGE",
+        "COMTNONLINEPOLLRESULT",
+        "COMTNORGNZTINFO",
+        "COMTNQAINFO",
+        "COMTNQESTNRINFO",
+        "COMTNQUSTNRIEM",
+        "COMTNQUSTNRQESITM",
+        "COMTNQUSTNRRESPONDINFO",
+        "COMTNQUSTNRRSPNSRESULT",
+        "COMTNQUSTNRTMPLAT"
+      ]
     },
     {
       "id": "uss.sam",
@@ -844,7 +1176,12 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 55
+      "approxFiles": 55,
+      "tables": [
+        "COMTNCPYRHTINFO",
+        "COMTNINDVDLINFOPOLICY",
+        "COMTNSTPLATINFO"
+      ]
     },
     {
       "id": "uss.umt",
@@ -859,7 +1196,15 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 82
+      "approxFiles": 82,
+      "tables": [
+        "COMTHEMPLYRINFOCHANGEDTLS",
+        "COMTNEMPLYRINFO",
+        "COMTNENTRPRSMBER",
+        "COMTNGNRLMBER",
+        "COMTNORGNZTINFO",
+        "COMTNSTPLATINFO"
+      ]
     },
     {
       "id": "utl.cal",
@@ -874,7 +1219,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 1
+      "approxFiles": 1,
+      "tables": []
     },
     {
       "id": "utl.cas",
@@ -889,7 +1235,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 2
+      "approxFiles": 2,
+      "tables": []
     },
     {
       "id": "utl.fcc",
@@ -904,7 +1251,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 13
+      "approxFiles": 13,
+      "tables": []
     },
     {
       "id": "utl.fda",
@@ -919,7 +1267,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 1
+      "approxFiles": 1,
+      "tables": []
     },
     {
       "id": "utl.jso",
@@ -934,7 +1283,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 3
+      "approxFiles": 3,
+      "tables": []
     },
     {
       "id": "utl.mdl",
@@ -949,7 +1299,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 1
+      "approxFiles": 1,
+      "tables": []
     },
     {
       "id": "utl.pao",
@@ -964,7 +1315,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 15
+      "approxFiles": 15,
+      "tables": []
     },
     {
       "id": "utl.sim",
@@ -979,7 +1331,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 11
+      "approxFiles": 11,
+      "tables": []
     },
     {
       "id": "utl.slm",
@@ -994,7 +1347,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 2
+      "approxFiles": 2,
+      "tables": []
     },
     {
       "id": "utl.sys",
@@ -1009,7 +1363,33 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 217
+      "approxFiles": 217,
+      "tables": [
+        "COMTCCMMNDETAILCODE",
+        "COMTHDBMNTRNGLOGINFO",
+        "COMTHHTTPMONLOGINFO",
+        "COMTHTRSMRCVMNTRNGLOGINFO",
+        "COMTNCNTCINSTT",
+        "COMTNCNTCSERVICE",
+        "COMTNCNTCSYSTEM",
+        "COMTNDBMNTRNG",
+        "COMTNFILESYSMNTRNG",
+        "COMTNFILESYSMNTRNGLOGINFO",
+        "COMTNHTTPMON",
+        "COMTNNTWRKSVCMNTRNG",
+        "COMTNNTWRKSVCMNTRNGLOGINFO",
+        "COMTNPROCESSMON",
+        "COMTNPROCESSMONLOGINFO",
+        "COMTNPROXYINFO",
+        "COMTNPROXYLOGINFO",
+        "COMTNSERVEREQPMNINFO",
+        "COMTNSERVEREQPMNRELATE",
+        "COMTNSERVERINFO",
+        "COMTNSERVERRESRCELOGINFO",
+        "COMTNSYNCHRNSERVERINFO",
+        "COMTNSYSTEMCNTC",
+        "COMTNTRSMRCVMNTRNG"
+      ]
     },
     {
       "id": "utl.wed",
@@ -1024,7 +1404,8 @@
       "dependsOn": [
         "cmm"
       ],
-      "approxFiles": 8
+      "approxFiles": 8,
+      "tables": []
     }
   ]
 }

package/dist/index.js

@@ -279,15 +279,59 @@ export async function addComponents(opts) {
         }
     if (plan.length === 0)
         throw new Error("복사할 파일이 없습니다 — 카탈로그 pathPrefixes를 확인하세요");
-    // DB 스크립트 수집
+    // DB 스크립트 수집 — 컴포넌트별 테이블 선별 추출 (M4)
     const sqlPlan = [];
     if (opts.database) {
+        const db = opts.database;
+        // 통합 스크립트 본문 로드 (ddl·dml)
+        const scriptText = new Map();
         for (const e of entries) {
             const r = rel(e.entryName);
             for (const kind of ["ddl", "dml"]) {
-                const prefix = `script/${kind}/${opts.database}/`;
-                if (r.startsWith(prefix))
-                    sqlPlan.push({ entry: e, relPath: `scripts/egovframe-components/${opts.database}/${kind}/` + r.slice(prefix.length) });
+                if (r.startsWith(`script/${kind}/${db}/`))
+                    scriptText.set(kind + ":" + r, e.getData().toString("utf8"));
+            }
+        }
+        /** 통합 스크립트에서 특정 테이블 관련 구문만 추출 */
+        const extractFor = (tables, kind) => {
+            const re = new RegExp("\\b(" + tables.join("|") + ")\\b");
+            const parts = [];
+            for (const [key, text] of scriptText) {
+                if (!key.startsWith(kind + ":"))
+                    continue;
+                for (const stmt of text.split(/;\s*(?:\r?\n|$)/)) {
+                    const t = stmt.trim();
+                    if (t && re.test(t))
+                        parts.push(t + ";");
+                }
+            }
+            return parts.join("\n\n");
+        };
+        const noTables = [];
+        for (const c of order) {
+            if (!c.tables || c.tables.length === 0) {
+                noTables.push(c);
+                continue;
+            }
+            for (const kind of ["ddl", "dml"]) {
+                const sql = extractFor(c.tables, kind);
+                if (sql)
+                    sqlPlan.push({
+                        relPath: `scripts/egovframe-components/${db}/${kind}/${c.id}.sql`,
+                        content: Buffer.from(`-- ${c.id} (${c.name}) — ${kind.toUpperCase()} 선별 추출: ${c.tables.join(", ")}\n\n` + sql + "\n", "utf8"),
+                        componentId: c.id,
+                    });
+            }
+        }
+        // 테이블 정보가 없는 컴포넌트가 있으면 통합본을 함께 복사 (폴백)
+        if (noTables.length > 0) {
+            for (const [key, text] of scriptText) {
+                const [kind, r] = [key.slice(0, 3), key.slice(4)];
+                sqlPlan.push({
+                    relPath: `scripts/egovframe-components/${db}/${kind}/` + r.split("/").pop(),
+                    content: Buffer.from(text, "utf8"),
+                    componentId: noTables[0].id,
+                });
             }
         }
     }
@@ -315,18 +359,22 @@ export async function addComponents(opts) {
         countBy.set(componentId, (countBy.get(componentId) ?? 0) + 1);
     }
     const sqlScripts = [];
-    for (const { entry, relPath } of sqlPlan) {
+    const sqlBy = new Map();
+    for (const { relPath, content, componentId } of sqlPlan) {
         const dest = path.join(projectDir, relPath);
         if (!dest.startsWith(projectDir + path.sep))
             continue;
         fs.mkdirSync(path.dirname(dest), { recursive: true });
-        fs.writeFileSync(dest, entry.getData());
+        fs.writeFileSync(dest, content);
         sqlScripts.push(relPath);
+        if (!sqlBy.has(componentId))
+            sqlBy.set(componentId, []);
+        sqlBy.get(componentId).push(relPath);
     }
     const nextSteps = [
         opts.database
-            ? `scripts/egovframe-components/${opts.database}/ 의 DDL·DML에서 설치한 컴포넌트 관련 테이블을 선별해 DB에 적용하세요 (통합 스크립트입니다).`
-            : "database 파라미터를 지정하면 DB DDL·DML 스크립트도 함께 복사됩니다.",
+            ? `scripts/egovframe-components/${opts.database}/ddl|dml/<컴포넌트id>.sql — 컴포넌트별로 선별 추출된 스크립트를 순서대로 DB에 적용하세요.`
+            : "database 파라미터를 지정하면 컴포넌트별로 선별 추출된 DDL·DML 스크립트도 함께 생성됩니다.",
         "복사된 소스는 egovframework.com.* 원본 패키지를 유지합니다 (eGovFrame IDE 마법사와 동일).",
         "빈 스캐너/설정에 egovframework.com 패키지 스캔이 포함되어 있는지 확인 후 mvn compile로 빌드를 검증하세요.",
         "일부 컴포넌트는 web.xml·필터·스케줄러 등 수동 설정이 필요할 수 있습니다 (공통컴포넌트 가이드 참조).",
@@ -348,7 +396,7 @@ export async function addComponents(opts) {
         manifest.components[c.id] = {
             installedAt: now,
             files: filesBy.get(c.id) ?? [],
-            sqlScripts: c === order[0] ? sqlScripts : [],
+            sqlScripts: sqlBy.get(c.id) ?? [],
         };
     writeManifest(projectDir, manifest);
     return {
@@ -512,7 +560,7 @@ export async function validateProject(opts) {
 /* MCP 서버                                                             */
 /* ------------------------------------------------------------------ */
 export function buildServer() {
-    const server = new McpServer({ name: "egovframe-scaffold-mcp", version: "0.5.0" });
+    const server = new McpServer({ name: "egovframe-scaffold-mcp", version: "0.6.0" });
     server.tool("list_egovframe_templates", "사용 가능한 전자정부 표준프레임워크 프로젝트 템플릿 목록을 반환합니다.", {}, async () => ({
         content: [
             {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "egovframe-scaffold-mcp",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "전자정부 표준프레임워크(eGovFrame) 프로젝트 스캐폴딩·공통컴포넌트 조립 MCP 서버 — create/search/add/validate/remove",
   "license": "Apache-2.0",
   "type": "module",