egovframe-scaffold-mcp 0.6.0 → 0.7.0

package/README.md

@@ -22,6 +22,7 @@ Claude, VS Code(Copilot), Cursor 등 MCP를 지원하는 AI 도구에서 **대
 | `search_egovframe_components` | 키워드로 컴포넌트 검색 (id·이름·설명, 점수순 상위 10건) |
 | `remove_egovframe_components` | 설치 매니페스트 기반 컴포넌트 제거 — 의존 컴포넌트 보호, `dryRun` 미리보기 |
 | `validate_egovframe_project` | 조립 프로젝트 무결성 진단 — 파일 존재·DbType↔DB 스크립트 일치 |
+| `get_egovframe_guide` | 컴포넌트의 공식 가이드 문서 조회 (egovframe-docs, 45종 매핑) |
 
 ### create_egovframe_project 파라미터
 
@@ -110,6 +111,8 @@ Claude Desktop / Claude Code 설정 예 (`mcpServers`):
 
 ## 변경 이력
 
+- **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` 생성(테이블 미상 컴포넌트는 통합본 폴백), 매니페스트에 컴포넌트별 스크립트 귀속(제거 시 함께 정리).
 
 - **0.5.0** — 조립 수명주기 완성: `search_egovframe_components`(키워드 검색), 설치 매니페스트(`.egovframe-components.json`) 기록, `remove_egovframe_components`(의존 보호·dryRun), `validate_egovframe_project`(파일 무결성·DbType↔DDL 일치 진단), 중복 설치 거부.

package/catalog/components.json

@@ -26,11 +26,25 @@
         "COMTNFILE",
         "COMTNFILEDETAIL",
         "COMTNORGNZTINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/user-authentication/login.md",
+          "title": "일반 로그인"
+        },
+        {
+          "path": "common-component/elementary-technology/showmodaldialog.md",
+          "title": "showmodaldialog.md"
+        },
+        {
+          "path": "common-component/security/login_session_management.md",
+          "title": "login_session_management.md"
+        }
       ]
     },
     {
       "id": "cop.adb",
-      "name": "cop.adb",
+      "name": "주소록 관리",
       "category": "cop",
       "description": "egovframework/com/cop/adb 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -49,6 +63,16 @@
         "COMTNENTRPRSMBER",
         "COMTNGNRLMBER",
         "COMTNNCRD"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/address-book.md",
+          "title": "주소록관리"
+        },
+        {
+          "path": "common-component/collaboration/business-card-management.md",
+          "title": "명함관리"
+        }
       ]
     },
     {
@@ -76,11 +100,29 @@
         "COMTNCOMMENT",
         "COMTNEMPLYRSCRTYESTBS",
         "COMTNTMPLATINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/blog-management.md",
+          "title": "블로그관리"
+        },
+        {
+          "path": "common-component/collaboration/board-integrated.md",
+          "title": "게시판(통합게시판)"
+        },
+        {
+          "path": "common-component/collaboration/board-management.md",
+          "title": "게시판관리"
+        },
+        {
+          "path": "common-component/collaboration/board-guestbook.md",
+          "title": "게시판(방명록)"
+        }
       ]
     },
     {
       "id": "cop.cmt",
-      "name": "cop.cmt",
+      "name": "댓글 관리",
       "category": "cop",
       "description": "egovframework/com/cop/cmt 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -94,11 +136,17 @@
       "approxFiles": 15,
       "tables": [
         "COMTNCOMMENT"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/comment-management.md",
+          "title": "댓글관리"
+        }
       ]
     },
     {
       "id": "cop.cmy",
-      "name": "cop.cmy",
+      "name": "커뮤니티 관리",
       "category": "cop",
       "description": "egovframework/com/cop/cmy 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -116,6 +164,20 @@
         "COMTNCMMNTY",
         "COMTNCMMNTYUSER",
         "COMTNTMPLATINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/community-creation.md",
+          "title": "커뮤니티생성관리"
+        },
+        {
+          "path": "common-component/collaboration/community-use.md",
+          "title": "커뮤니티사용관리"
+        },
+        {
+          "path": "common-component/collaboration/community-member.md",
+          "title": "커뮤니티회원관리"
+        }
       ]
     },
     {
@@ -137,11 +199,12 @@
         "COMTNCLUBUSER",
         "COMTNCMMNTY",
         "COMTNCMMNTYUSER"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "cop.ems",
-      "name": "cop.ems",
+      "name": "전자우편(발송메일)",
       "category": "cop",
       "description": "egovframework/com/cop/ems 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -157,6 +220,12 @@
         "COMTCCMMNDETAILCODE",
         "COMTHEMAILDSPTCHMANAGE",
         "COMTNFILEDETAIL"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/email.md",
+          "title": "전자우편"
+        }
       ]
     },
     {
@@ -176,11 +245,12 @@
       "tables": [
         "COMTNNCRD",
         "COMTNNCRDUSER"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "cop.scp",
-      "name": "cop.scp",
+      "name": "스크랩 관리",
       "category": "cop",
       "description": "egovframework/com/cop/scp 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -194,11 +264,17 @@
       "approxFiles": 18,
       "tables": [
         "COMTNSCRAP"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/scrap-management.md",
+          "title": "스크랩관리"
+        }
       ]
     },
     {
       "id": "cop.sms",
-      "name": "cop.sms",
+      "name": "문자메시지 서비스",
       "category": "cop",
       "description": "egovframework/com/cop/sms 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -213,6 +289,12 @@
       "tables": [
         "COMTNSMS",
         "COMTNSMSRECPTN"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/sms-service.md",
+          "title": "문자메시지서비스"
+        }
       ]
     },
     {
@@ -244,11 +326,33 @@
         "COMTNORGNZTINFO",
         "COMTNSCHDULINFO",
         "COMTNWIKMNTHNGREPRT"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/executive-schedule.md",
+          "title": "간부일정관리"
+        },
+        {
+          "path": "common-component/collaboration/department-schedule.md",
+          "title": "부서일정관리"
+        },
+        {
+          "path": "common-component/collaboration/schedule-management.md",
+          "title": "일정관리"
+        },
+        {
+          "path": "common-component/collaboration/journal-management.md",
+          "title": "일지관리"
+        },
+        {
+          "path": "common-component/collaboration/department-task-box.md",
+          "title": "부서업무함관리"
+        }
       ]
     },
     {
       "id": "cop.stf",
-      "name": "cop.stf",
+      "name": "만족도 조사",
       "category": "cop",
       "description": "egovframework/com/cop/stf 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -262,11 +366,17 @@
       "approxFiles": 12,
       "tables": [
         "COMTNSTSFDG"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/satisfaction-survey.md",
+          "title": "만족도조사"
+        }
       ]
     },
     {
       "id": "cop.tpl",
-      "name": "cop.tpl",
+      "name": "템플릿 관리",
       "category": "cop",
       "description": "egovframework/com/cop/tpl 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -283,11 +393,17 @@
         "COMTNBBSMASTER",
         "COMTNEMPLYRINFO",
         "COMTNTMPLATINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/collaboration/template-management.md",
+          "title": "템플릿관리"
+        }
       ]
     },
     {
       "id": "dam.app",
-      "name": "dam.app",
+      "name": "지식평가 관리",
       "category": "dam",
       "description": "egovframework/com/dam/app 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -304,11 +420,17 @@
         "COMTNDAMMAPKNO",
         "COMTNDAMMAPTEAM",
         "COMTNDAMPRO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/digital-asset-management/knowledge-evaluation-manage.md",
+          "title": "지식평가관리"
+        }
       ]
     },
     {
       "id": "dam.map",
-      "name": "dam.map",
+      "name": "지식맵 관리",
       "category": "dam",
       "description": "egovframework/com/dam/map 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -323,11 +445,21 @@
       "tables": [
         "COMTNDAMMAPKNO",
         "COMTNDAMMAPTEAM"
+      ],
+      "docs": [
+        {
+          "path": "common-component/digital-asset-management/org-knowledge-map-management.md",
+          "title": "지식맵관리(조직)"
+        },
+        {
+          "path": "common-component/digital-asset-management/type-knowledge-map-management.md",
+          "title": "지식맵관리(유형)"
+        }
       ]
     },
     {
       "id": "dam.mgm",
-      "name": "dam.mgm",
+      "name": "지식정보 관리",
       "category": "dam",
       "description": "egovframework/com/dam/mgm 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -344,11 +476,17 @@
         "COMTNDAMMAPKNO",
         "COMTNDAMMAPTEAM",
         "COMTNEMPLYRSCRTYESTBS"
+      ],
+      "docs": [
+        {
+          "path": "common-component/digital-asset-management/knowledge-info-manage.md",
+          "title": "지식정보관리"
+        }
       ]
     },
     {
       "id": "dam.per",
-      "name": "dam.per",
+      "name": "개인지식 관리",
       "category": "dam",
       "description": "egovframework/com/dam/per 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -364,11 +502,17 @@
         "COMTNDAMKNOIFM",
         "COMTNDAMMAPKNO",
         "COMTNDAMMAPTEAM"
+      ],
+      "docs": [
+        {
+          "path": "common-component/digital-asset-management/personal-knowledge-manage.md",
+          "title": "개인지식관리"
+        }
       ]
     },
     {
       "id": "dam.spe",
-      "name": "dam.spe",
+      "name": "지식전문가 관리",
       "category": "dam",
       "description": "egovframework/com/dam/spe 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -386,6 +530,12 @@
         "COMTNDAMMAPTEAM",
         "COMTNDAMPRO",
         "COMTNEMPLYRINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/digital-asset-management/knowledge-expert-manage.md",
+          "title": "지식전문가관리"
+        }
       ]
     },
     {
@@ -402,7 +552,8 @@
         "cmm"
       ],
       "approxFiles": 3,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "ext.easybatch",
@@ -418,7 +569,8 @@
         "cmm"
       ],
       "approxFiles": 2,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "ext.ldapumt",
@@ -434,7 +586,8 @@
         "cmm"
       ],
       "approxFiles": 14,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "ext.msg",
@@ -450,7 +603,13 @@
         "cmm"
       ],
       "approxFiles": 15,
-      "tables": []
+      "tables": [],
+      "docs": [
+        {
+          "path": "common-component/elementary-technology/websocket_messenger.md",
+          "title": "websocket_messenger.md"
+        }
+      ]
     },
     {
       "id": "ext.oauth",
@@ -466,7 +625,8 @@
         "cmm"
       ],
       "approxFiles": 6,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "sec.drm",
@@ -486,6 +646,12 @@
         "COMTNEMPLYRINFO",
         "COMTNEMPLYRSCRTYESTBS",
         "COMTNORGNZTINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/security/department-role-management.md",
+          "title": "department-role-management.md"
+        }
       ]
     },
     {
@@ -504,6 +670,12 @@
       "approxFiles": 18,
       "tables": [
         "COMTNAUTHORGROUPINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/security/group-management.md",
+          "title": "group-management.md"
+        }
       ]
     },
     {
@@ -520,7 +692,13 @@
         "cmm"
       ],
       "approxFiles": 2,
-      "tables": []
+      "tables": [],
+      "docs": [
+        {
+          "path": "common-component/security/encrypt_decrypt.md",
+          "title": "encrypt_decrypt.md"
+        }
+      ]
     },
     {
       "id": "sec.ram",
@@ -540,6 +718,16 @@
         "COMTNAUTHORINFO",
         "COMTNAUTHORROLERELATE",
         "COMTNROLEINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/security/authority-management-function.md",
+          "title": "권한관리 기능"
+        },
+        {
+          "path": "common-component/security/authority-role-management.md",
+          "title": "권한별 롤관리"
+        }
       ]
     },
     {
@@ -562,6 +750,12 @@
         "COMTNEMPLYRSCRTYESTBS",
         "COMTNENTRPRSMBER",
         "COMTNGNRLMBER"
+      ],
+      "docs": [
+        {
+          "path": "common-component/security/authority-group-management.md",
+          "title": "authority-group-management.md"
+        }
       ]
     },
     {
@@ -581,6 +775,12 @@
       "tables": [
         "COMTCCMMNDETAILCODE",
         "COMTNROLEINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/security/role-management.md",
+          "title": "role-management.md"
+        }
       ]
     },
     {
@@ -597,7 +797,8 @@
         "cmm"
       ],
       "approxFiles": 1,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "ssi.syi",
@@ -621,6 +822,24 @@
         "COMTNCNTCSYSTEM",
         "COMTNSYSTEMCNTC",
         "COMTNTRSMRCVLOG"
+      ],
+      "docs": [
+        {
+          "path": "common-component/system-service-linkage/linkage-org-manage.md",
+          "title": "연계기관관리"
+        },
+        {
+          "path": "common-component/system-service-linkage/linkage-message-manage.md",
+          "title": "연계메시지관리"
+        },
+        {
+          "path": "common-component/system-service-linkage/system-linkage-manage.md",
+          "title": "시스템연계관리"
+        },
+        {
+          "path": "common-component/system-service-linkage/linkage-status-manage.md",
+          "title": "연계현황관리"
+        }
       ]
     },
     {
@@ -642,6 +861,12 @@
         "COMTNBBSMASTER",
         "COMTNTMPLATINFO",
         "COMTSBBSSUMMARY"
+      ],
+      "docs": [
+        {
+          "path": "common-component/statistics-reporting/post-statistics.md",
+          "title": "post-statistics.md"
+        }
       ]
     },
     {
@@ -658,7 +883,8 @@
         "cmm"
       ],
       "approxFiles": 1,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "sts.cst",
@@ -677,6 +903,12 @@
       "tables": [
         "COMTNLOGINLOG",
         "COMTSSYSLOGSUMMARY"
+      ],
+      "docs": [
+        {
+          "path": "common-component/statistics-reporting/connection-statistics.md",
+          "title": "connection-statistics.md"
+        }
       ]
     },
     {
@@ -699,6 +931,12 @@
         "COMTNDTAUSESTATS",
         "COMTNFILE",
         "COMTNFILEDETAIL"
+      ],
+      "docs": [
+        {
+          "path": "common-component/statistics-reporting/data-use-statistics.md",
+          "title": "data-use-statistics.md"
+        }
       ]
     },
     {
@@ -718,6 +956,12 @@
       "tables": [
         "COMTCCMMNDETAILCODE",
         "COMTNREPRTSTATS"
+      ],
+      "docs": [
+        {
+          "path": "common-component/statistics-reporting/report-statistics.md",
+          "title": "report-statistics.md"
+        }
       ]
     },
     {
@@ -737,6 +981,12 @@
       "tables": [
         "COMTNPROGRMLIST",
         "COMTSWEBLOGSUMMARY"
+      ],
+      "docs": [
+        {
+          "path": "common-component/statistics-reporting/screen-statistics.md",
+          "title": "screen-statistics.md"
+        }
       ]
     },
     {
@@ -758,6 +1008,12 @@
         "COMTNENTRPRSMBER",
         "COMTNGNRLMBER",
         "COMTSUSERSUMMARY"
+      ],
+      "docs": [
+        {
+          "path": "common-component/statistics-reporting/user-statistics.md",
+          "title": "user-statistics.md"
+        }
       ]
     },
     {
@@ -774,7 +1030,8 @@
         "cmm"
       ],
       "approxFiles": 2,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "sym.bat",
@@ -796,11 +1053,21 @@
         "COMTNBATCHRESULT",
         "COMTNBATCHSCHDUL",
         "COMTNBATCHSCHDULDFK"
+      ],
+      "docs": [
+        {
+          "path": "common-component/system-management/batch-job-management.md",
+          "title": "배치작업관리"
+        },
+        {
+          "path": "common-component/system-management/batch-result-management.md",
+          "title": "배치결과관리"
+        }
       ]
     },
     {
       "id": "sym.cal",
-      "name": "sym.cal",
+      "name": "달력(휴일) 관리",
       "category": "sym",
       "description": "egovframework/com/sym/cal 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -815,6 +1082,12 @@
       "tables": [
         "COMTCCMMNDETAILCODE",
         "COMTNRESTDE"
+      ],
+      "docs": [
+        {
+          "path": "common-component/elementary-technology/calendar.md",
+          "title": "달력"
+        }
       ]
     },
     {
@@ -841,6 +1114,16 @@
         "COMTNINSTTCODE",
         "COMTNINSTTCODERECPTNLOG",
         "COMTRDNMADRZIP"
+      ],
+      "docs": [
+        {
+          "path": "common-component/system-management/legal-dong-code.md",
+          "title": "법정동코드"
+        },
+        {
+          "path": "common-component/system-management/org-code.md",
+          "title": "기관코드"
+        }
       ]
     },
     {
@@ -869,6 +1152,28 @@
         "COMTSSYSLOGSUMMARY",
         "COMTSTRSMRCVLOGSUMMARY",
         "COMTSWEBLOGSUMMARY"
+      ],
+      "docs": [
+        {
+          "path": "common-component/system-management/privacy-log-management.md",
+          "title": "개인정보조회로그관리"
+        },
+        {
+          "path": "common-component/system-management/web-log-management.md",
+          "title": "웹로그관리"
+        },
+        {
+          "path": "common-component/system-management/log-management.md",
+          "title": "로그관리"
+        },
+        {
+          "path": "common-component/system-management/access-log-management.md",
+          "title": "접속로그관리"
+        },
+        {
+          "path": "common-component/system-management/send-receive-log-management.md",
+          "title": "송/수신 로그관리"
+        }
       ]
     },
     {
@@ -893,7 +1198,8 @@
         "COMTNMENUINFO",
         "COMTNPROGRMLIST",
         "COMTNSITEMAP"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "sym.prm",
@@ -912,7 +1218,8 @@
       "tables": [
         "COMTHPROGRMCHANGEDTLS",
         "COMTNPROGRMLIST"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "sym.sym",
@@ -937,7 +1244,8 @@
         "COMTNSERVEREQPMNINFO",
         "COMTNSERVEREQPMNRELATE",
         "COMTNSERVERINFO"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "sym.tbm",
@@ -956,7 +1264,8 @@
       "tables": [
         "COMTCCMMNDETAILCODE",
         "COMTNTROBLINFO"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "uat.sso",
@@ -972,7 +1281,8 @@
         "cmm"
       ],
       "approxFiles": 3,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "uat.uap",
@@ -990,6 +1300,12 @@
       "approxFiles": 18,
       "tables": [
         "COMTNLOGINPOLICY"
+      ],
+      "docs": [
+        {
+          "path": "common-component/user-authentication/login-policy-management.md",
+          "title": "로그인정책관리"
+        }
       ]
     },
     {
@@ -1010,6 +1326,24 @@
         "COMTNEMPLYRINFO",
         "COMTNENTRPRSMBER",
         "COMTNGNRLMBER"
+      ],
+      "docs": [
+        {
+          "path": "common-component/user-authentication/certificate-login.md",
+          "title": "인증서로그인"
+        },
+        {
+          "path": "common-component/elementary-technology/social_login_naver_google_kakao.md",
+          "title": "social_login_naver_google_kakao.md"
+        },
+        {
+          "path": "common-component/security/pw_expiration_management.md",
+          "title": "pw_expiration_management.md"
+        },
+        {
+          "path": "common-component/user-authentication/sso_service.md",
+          "title": "sso_service.md"
+        }
       ]
     },
     {
@@ -1028,6 +1362,12 @@
       "approxFiles": 15,
       "tables": [
         "COMTNCOMMUTE"
+      ],
+      "docs": [
+        {
+          "path": "common-component/elementary-technology/cmtmanage.md",
+          "title": "cmtmanage.md"
+        }
       ]
     },
     {
@@ -1085,6 +1425,28 @@
         "COMTNUSERABSNCE",
         "COMTNVCATNMANAGE",
         "COMTNWIKIBKMK"
+      ],
+      "docs": [
+        {
+          "path": "common-component/user-support/anniversary.md",
+          "title": "기념일관리"
+        },
+        {
+          "path": "common-component/user-support/vacation-management.md",
+          "title": "휴가관리"
+        },
+        {
+          "path": "common-component/user-support/event-application.md",
+          "title": "행사신청관리"
+        },
+        {
+          "path": "common-component/user-support/event-reception.md",
+          "title": "행사접수관리"
+        },
+        {
+          "path": "common-component/user-support/integrated-link.md",
+          "title": "통합링크관리"
+        }
       ]
     },
     {
@@ -1103,7 +1465,8 @@
       "approxFiles": 17,
       "tables": [
         "COMTNINDVDLPGECNTNTS"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "uss.olh",
@@ -1129,6 +1492,28 @@
         "COMTNORGNZTINFO",
         "COMTNQAINFO",
         "COMTNWORDDICARYINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/user-support/admin-terminology.md",
+          "title": "행정전문용어사전관리"
+        },
+        {
+          "path": "common-component/user-support/online-manual.md",
+          "title": "온라인매뉴얼"
+        },
+        {
+          "path": "common-component/user-support/faq-management.md",
+          "title": "FAQ관리"
+        },
+        {
+          "path": "common-component/user-support/glossary.md",
+          "title": "용어사전"
+        },
+        {
+          "path": "common-component/user-support/help.md",
+          "title": "도움말"
+        }
       ]
     },
     {
@@ -1161,6 +1546,28 @@
         "COMTNQUSTNRRESPONDINFO",
         "COMTNQUSTNRRSPNSRESULT",
         "COMTNQUSTNRTMPLAT"
+      ],
+      "docs": [
+        {
+          "path": "common-component/user-support/counseling-management.md",
+          "title": "상담관리"
+        },
+        {
+          "path": "common-component/user-support/meeting-management.md",
+          "title": "회의관리"
+        },
+        {
+          "path": "common-component/user-support/survey-item.md",
+          "title": "설문항목관리"
+        },
+        {
+          "path": "common-component/user-support/survey-management.md",
+          "title": "설문관리"
+        },
+        {
+          "path": "common-component/user-support/survey-template.md",
+          "title": "설문템플릿관리"
+        }
       ]
     },
     {
@@ -1181,7 +1588,8 @@
         "COMTNCPYRHTINFO",
         "COMTNINDVDLINFOPOLICY",
         "COMTNSTPLATINFO"
-      ]
+      ],
+      "docs": []
     },
     {
       "id": "uss.umt",
@@ -1204,6 +1612,12 @@
         "COMTNGNRLMBER",
         "COMTNORGNZTINFO",
         "COMTNSTPLATINFO"
+      ],
+      "docs": [
+        {
+          "path": "common-component/user-support/company-member-management.md",
+          "title": "기업 회원 관리"
+        }
       ]
     },
     {
@@ -1220,7 +1634,8 @@
         "cmm"
       ],
       "approxFiles": 1,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "utl.cas",
@@ -1236,7 +1651,8 @@
         "cmm"
       ],
       "approxFiles": 2,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "utl.fcc",
@@ -1252,7 +1668,29 @@
         "cmm"
       ],
       "approxFiles": 13,
-      "tables": []
+      "tables": [],
+      "docs": [
+        {
+          "path": "common-component/elementary-technology/date-time-day-calculation.md",
+          "title": "날짜/시간/요일 계산"
+        },
+        {
+          "path": "common-component/elementary-technology/date-time-day-conversion.md",
+          "title": "날짜/시간/요일 변환"
+        },
+        {
+          "path": "common-component/elementary-technology/date-time-day-format.md",
+          "title": "날짜/시간/요일 포맷변경"
+        },
+        {
+          "path": "common-component/elementary-technology/date-time-day-validation.md",
+          "title": "날짜/시간/요일 유효성체크"
+        },
+        {
+          "path": "common-component/elementary-technology/id-number-validation.md",
+          "title": "번호유효성체크"
+        }
+      ]
     },
     {
       "id": "utl.fda",
@@ -1268,7 +1706,8 @@
         "cmm"
       ],
       "approxFiles": 1,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "utl.jso",
@@ -1284,7 +1723,8 @@
         "cmm"
       ],
       "approxFiles": 3,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "utl.mdl",
@@ -1300,11 +1740,12 @@
         "cmm"
       ],
       "approxFiles": 1,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "utl.pao",
-      "name": "utl.pao",
+      "name": "인쇄/출력",
       "category": "utl",
       "description": "egovframework/com/utl/pao 하위 소스·매퍼·JSP (자동 생성 항목)",
       "pathPrefixes": [
@@ -1316,7 +1757,17 @@
         "cmm"
       ],
       "approxFiles": 15,
-      "tables": []
+      "tables": [],
+      "docs": [
+        {
+          "path": "common-component/elementary-technology/print_digital_seal.md",
+          "title": "print_digital_seal.md"
+        },
+        {
+          "path": "common-component/elementary-technology/print.md",
+          "title": "인쇄/출력"
+        }
+      ]
     },
     {
       "id": "utl.sim",
@@ -1332,7 +1783,17 @@
         "cmm"
       ],
       "approxFiles": 11,
-      "tables": []
+      "tables": [],
+      "docs": [
+        {
+          "path": "common-component/elementary-technology/directory-create.md",
+          "title": "디렉토리생성"
+        },
+        {
+          "path": "common-component/elementary-technology/file-download.md",
+          "title": "파일다운로드"
+        }
+      ]
     },
     {
       "id": "utl.slm",
@@ -1348,7 +1809,8 @@
         "cmm"
       ],
       "approxFiles": 2,
-      "tables": []
+      "tables": [],
+      "docs": []
     },
     {
       "id": "utl.sys",
@@ -1389,6 +1851,24 @@
         "COMTNSYNCHRNSERVERINFO",
         "COMTNSYSTEMCNTC",
         "COMTNTRSMRCVMNTRNG"
+      ],
+      "docs": [
+        {
+          "path": "common-component/elementary-technology/proxy-service.md",
+          "title": "프록시서비스"
+        },
+        {
+          "path": "common-component/elementary-technology/network-service-monitoring.md",
+          "title": "네트워크서비스모니터링"
+        },
+        {
+          "path": "common-component/elementary-technology/db-service-monitoring.md",
+          "title": "DB서비스모니터링"
+        },
+        {
+          "path": "common-component/elementary-technology/send-receive-monitoring.md",
+          "title": "송수신모니터링"
+        }
       ]
     },
     {
@@ -1405,7 +1885,8 @@
         "cmm"
       ],
       "approxFiles": 8,
-      "tables": []
+      "tables": [],
+      "docs": []
     }
   ]
 }

package/catalog/overrides.json

@@ -1,15 +1,89 @@
 {
   "_comment": "generate-catalog.mjs가 사용하는 수동 큐레이션 오버레이. key는 패키지 경로 기준 기본 id.",
-  "cmm": { "name": "공통기반 (Common)", "description": "공통 유틸리티·서비스·필터·공용 JSP 등 대부분의 컴포넌트가 의존하는 공통기반 모듈" },
-  "cop.bbs": { "id": "bbs", "name": "게시판 (BBS)", "description": "게시판 생성·게시글 관리(블로그형 포함) 협업 컴포넌트" },
-  "uat.uia": { "id": "login", "name": "로그인/인증 (uat.uia)", "description": "일반·Spring Security 로그인 처리 사용자인증 컴포넌트" },
-  "uat.uap": { "name": "로그인 정책관리" },
-  "uat.sso": { "name": "SSO 연계" },
-  "uss.umt": { "name": "일반회원 관리" },
-  "sym.mnu": { "name": "메뉴 관리" },
-  "sym.ccm": { "name": "공통코드 관리" },
-  "sym.log": { "name": "시스템 로그 관리" },
-  "sym.bat": { "name": "배치 관리" },
-  "sec.ram": { "name": "권한 관리" },
-  "cop.smt": { "name": "일정 관리" }
+  "cmm": {
+    "name": "공통기반 (Common)",
+    "description": "공통 유틸리티·서비스·필터·공용 JSP 등 대부분의 컴포넌트가 의존하는 공통기반 모듈"
+  },
+  "cop.bbs": {
+    "id": "bbs",
+    "name": "게시판 (BBS)",
+    "description": "게시판 생성·게시글 관리(블로그형 포함) 협업 컴포넌트"
+  },
+  "uat.uia": {
+    "id": "login",
+    "name": "로그인/인증 (uat.uia)",
+    "description": "일반·Spring Security 로그인 처리 사용자인증 컴포넌트"
+  },
+  "uat.uap": {
+    "name": "로그인 정책관리"
+  },
+  "uat.sso": {
+    "name": "SSO 연계"
+  },
+  "uss.umt": {
+    "name": "일반회원 관리"
+  },
+  "sym.mnu": {
+    "name": "메뉴 관리"
+  },
+  "sym.ccm": {
+    "name": "공통코드 관리"
+  },
+  "sym.log": {
+    "name": "시스템 로그 관리"
+  },
+  "sym.bat": {
+    "name": "배치 관리"
+  },
+  "sec.ram": {
+    "name": "권한 관리"
+  },
+  "cop.smt": {
+    "name": "일정 관리"
+  },
+  "cop.adb": {
+    "name": "주소록 관리"
+  },
+  "cop.cmt": {
+    "name": "댓글 관리"
+  },
+  "cop.cmy": {
+    "name": "커뮤니티 관리"
+  },
+  "cop.ems": {
+    "name": "전자우편(발송메일)"
+  },
+  "cop.scp": {
+    "name": "스크랩 관리"
+  },
+  "cop.sms": {
+    "name": "문자메시지 서비스"
+  },
+  "cop.stf": {
+    "name": "만족도 조사"
+  },
+  "cop.tpl": {
+    "name": "템플릿 관리"
+  },
+  "dam.app": {
+    "name": "지식평가 관리"
+  },
+  "dam.map": {
+    "name": "지식맵 관리"
+  },
+  "dam.mgm": {
+    "name": "지식정보 관리"
+  },
+  "dam.per": {
+    "name": "개인지식 관리"
+  },
+  "dam.spe": {
+    "name": "지식전문가 관리"
+  },
+  "sym.cal": {
+    "name": "달력(휴일) 관리"
+  },
+  "utl.pao": {
+    "name": "인쇄/출력"
+  }
 }

package/dist/index.js

@@ -557,10 +557,37 @@ export async function validateProject(opts) {
     return { projectDir, ok: warnings.length === 0, manifestFound: manifest !== null, components, dbType, dbScriptDirs, warnings };
 }
 /* ------------------------------------------------------------------ */
+/* 가이드 문서 조회 (v0.7.0)                                            */
+/* ------------------------------------------------------------------ */
+export const DOCS_REPO = "eGovFramework/egovframe-docs";
+export const GUIDE_MAX_CHARS = 15_000;
+/** 컴포넌트의 공식 가이드 문서를 egovframe-docs에서 가져온다. */
+export async function getGuide(componentId, docIndex = 0) {
+    const catalog = loadCatalog();
+    const comp = catalog.components.find((c) => c.id === componentId);
+    if (!comp)
+        throw new Error(`알 수 없는 컴포넌트 id: '${componentId}' — search_egovframe_components로 검색해 보세요`);
+    const docs = comp.docs ?? [];
+    if (docs.length === 0)
+        return { componentId, docs: [], selected: null, content: null, truncated: false };
+    if (docIndex < 0 || docIndex >= docs.length)
+        throw new Error(`docIndex는 0~${docs.length - 1} 범위여야 합니다 (문서 ${docs.length}건)`);
+    const sel = docs[docIndex];
+    const url = `https://raw.githubusercontent.com/${DOCS_REPO}/main/${sel.path}`;
+    const res = await fetchWithTimeout(url, DOWNLOAD_TIMEOUT_MS);
+    if (!res.ok)
+        throw new Error(`가이드 문서 다운로드 실패 (${res.status}): ${url}`);
+    let content = await res.text();
+    const truncated = content.length > GUIDE_MAX_CHARS;
+    if (truncated)
+        content = content.slice(0, GUIDE_MAX_CHARS);
+    return { componentId, docs, selected: sel, content, truncated };
+}
+/* ------------------------------------------------------------------ */
 /* MCP 서버                                                             */
 /* ------------------------------------------------------------------ */
 export function buildServer() {
-    const server = new McpServer({ name: "egovframe-scaffold-mcp", version: "0.6.0" });
+    const server = new McpServer({ name: "egovframe-scaffold-mcp", version: "0.7.0" });
     server.tool("list_egovframe_templates", "사용 가능한 전자정부 표준프레임워크 프로젝트 템플릿 목록을 반환합니다.", {}, async () => ({
         content: [
             {
@@ -682,6 +709,23 @@ export function buildServer() {
         ].join("\n");
         return { content: [{ type: "text", text }] };
     });
+    server.tool("get_egovframe_guide", "컴포넌트의 공식 가이드 문서(표준프레임워크 포털 egovframe-docs)를 가져옵니다. " +
+        "문서가 여러 건이면 목록을 함께 반환하며 docIndex로 선택할 수 있습니다.", {
+        component: z.string().describe("컴포넌트 id. 예: bbs, login, cop.cmy"),
+        docIndex: z.number().int().min(0).default(0).describe("문서가 여러 건일 때 선택 (0부터, 기본 0)"),
+    }, async (args) => {
+        const r = await getGuide(args.component, args.docIndex);
+        if (!r.selected)
+            return { content: [{ type: "text", text: `'${r.componentId}'에 매핑된 가이드 문서가 없습니다. list_egovframe_components로 다른 컴포넌트를 확인하세요.` }] };
+        const head = [
+            `📘 ${r.selected.title} — ${r.componentId}`,
+            `문서: https://github.com/${DOCS_REPO}/blob/main/${r.selected.path}`,
+            r.docs.length > 1 ? `관련 문서 ${r.docs.length}건: ` + r.docs.map((d, i) => `[${i}] ${d.title}`).join(", ") : "",
+            r.truncated ? `(본문이 길어 ${GUIDE_MAX_CHARS}자로 잘렸습니다 — 전문은 링크 참조)` : "",
+            "", "---", "",
+        ].filter((l, i) => l !== "" || i >= 4).join("\n");
+        return { content: [{ type: "text", text: head + r.content }] };
+    });
     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.6.0",
+  "version": "0.7.0",
   "description": "전자정부 표준프레임워크(eGovFrame) 프로젝트 스캐폴딩·공통컴포넌트 조립 MCP 서버 — create/search/add/validate/remove",
   "license": "Apache-2.0",
   "type": "module",