@bimatrix-aud-platform/aud_mcp_server 1.1.14 → 1.1.16

package/dist/index.js

@@ -35,6 +35,26 @@ catch (error) {
     console.error("Failed to load module schema:", error);
     process.exit(1);
 }
+// Load json2 schema
+const json2SchemaPath = join(__dirname, "..", "schemas", "json2.schema.json");
+let json2Schema;
+try {
+    json2Schema = JSON.parse(readFileSync(json2SchemaPath, "utf-8"));
+}
+catch (error) {
+    console.error("Failed to load json2 schema:", error);
+    process.exit(1);
+}
+// Load ds schema
+const dsSchemaPath = join(__dirname, "..", "schemas", "ds.schema.json");
+let dsSchema;
+try {
+    dsSchema = JSON.parse(readFileSync(dsSchemaPath, "utf-8"));
+}
+catch (error) {
+    console.error("Failed to load ds schema:", error);
+    process.exit(1);
+}
 // Initialize AJV validator
 const ajv = new Ajv.default({
     allErrors: true,
@@ -44,6 +64,8 @@ const ajv = new Ajv.default({
 addFormats.default(ajv);
 const validate = ajv.compile(mtsdSchema);
 const validateModule = ajv.compile(moduleSchema);
+const validateJson2 = ajv.compile(json2Schema);
+const validateDs = ajv.compile(dsSchema);
 // Error message translation (Korean)
 function translateError(error) {
     const path = error.instancePath || "(root)";
@@ -142,14 +164,39 @@ const tools = [
                         "DataSources",
                         "Form",
                         "Element",
+                        // Display
                         "LabelElement",
                         "ButtonElement",
-                        "DataGridElement",
-                        "GroupElement",
-                        "ComboBoxElement",
-                        "CheckBoxElement",
+                        "ImageElement",
+                        // Input
                         "TextBoxElement",
+                        "MaskTextBoxElement",
                         "NumberBoxElement",
+                        "RichTextBoxElement",
+                        "ComboBoxElement",
+                        "MultiComboBoxElement",
+                        "PickListElement",
+                        "CheckBoxElement",
+                        "RadioButtonElement",
+                        "ColorSelectorElement",
+                        "SliderElement",
+                        "CalendarElement",
+                        "FileUploadButtonElement",
+                        // Grid
+                        "DataGridElement",
+                        "TreeGridElement",
+                        "OlapGridElement",
+                        "iGridElement",
+                        // Chart
+                        "ChartElement",
+                        // Container / Layout
+                        "GroupElement",
+                        "TabElement",
+                        "TableLayoutElement",
+                        "UserComponentElement",
+                        // Etc
+                        "WebContainerElement",
+                        // Non-Element
                         "Variable",
                         "Module",
                         "ExecutionPlan",
@@ -185,15 +232,40 @@ const tools = [
                         "Font",
                         "Border",
                         "Background",
+                        // Display
                         "LabelElement",
                         "ButtonElement",
-                        "DataGridElement",
-                        "GroupElement",
-                        "ComboBoxElement",
-                        "CheckBoxElement",
+                        "ImageElement",
+                        // Input
                         "TextBoxElement",
+                        "MaskTextBoxElement",
                         "NumberBoxElement",
+                        "RichTextBoxElement",
+                        "ComboBoxElement",
+                        "MultiComboBoxElement",
+                        "PickListElement",
+                        "CheckBoxElement",
+                        "RadioButtonElement",
+                        "ColorSelectorElement",
+                        "SliderElement",
+                        "CalendarElement",
+                        "FileUploadButtonElement",
+                        // Grid
+                        "DataGridElement",
+                        "TreeGridElement",
+                        "OlapGridElement",
+                        "iGridElement",
                         "GridColumn",
+                        // Chart
+                        "ChartElement",
+                        // Container / Layout
+                        "GroupElement",
+                        "TabElement",
+                        "TableLayoutElement",
+                        "UserComponentElement",
+                        // Etc
+                        "WebContainerElement",
+                        // Non-Element
                         "Variable",
                         "Module",
                         "ExecutionPlan",
@@ -233,11 +305,25 @@ const tools = [
                     type: "string",
                     description: "Element 타입",
                     enum: [
-                        "Label", "Button", "DataGrid", "Group", "Image",
-                        "RichTextBox", "CheckBox", "ComboBox", "TextBox", "NumberBox",
-                        "RadioButton", "Chart", "PieChart", "ScatterChart", "TreeGrid",
-                        "OlapGrid", "Slider", "FileUpload", "Browser", "ColorPicker",
-                        "MultiComboBox", "PickList", "UserComponent", "ListGrid",
+                        // Display
+                        "Label", "Button", "Image",
+                        // Input
+                        "TextBox", "MaskTextBox", "NumberBox", "RichTextBox",
+                        "ComboBox", "MultiComboBox", "PickList",
+                        "CheckBox", "RadioButton", "Tree",
+                        "ColorSelector", "Slider",
+                        "Calendar", "CalendarYear", "CalendarYM",
+                        "FileUploadButton",
+                        // Grid
+                        "DataGrid", "TreeGrid", "OlapGrid", "iGrid", "CompactDataGrid",
+                        // TreeView
+                        "TreeView",
+                        // Chart
+                        "Chart", "PieChart", "ScatterChart", "PolygonChart",
+                        // Container / Layout
+                        "Group", "Tab", "AddIn", "UserComponent",
+                        // Etc
+                        "WebContainer", "DiagramControl", "Slicer",
                     ],
                 },
                 id: {
@@ -439,6 +525,28 @@ const tools = [
             },
         },
     },
+    {
+        name: "validate_mxgrid",
+        description: "MX-GRID 템플릿(.json2) 및 데이터셋(.ds) 파일을 검증합니다. 파일 경로 또는 JSON 문자열/객체를 받아 스키마 준수 여부를 확인하고, 비즈니스 로직 경고(스타일 참조 불일치, 시트명 참조 불일치 등)도 포함합니다.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "파일의 전체 경로 (.json2 또는 .ds 확장자). 확장자로 타입을 자동 감지합니다.",
+                },
+                document: {
+                    type: ["string", "object"],
+                    description: "검증할 JSON 문서 (JSON 문자열 또는 객체). path와 document 중 하나를 지정합니다.",
+                },
+                type: {
+                    type: "string",
+                    enum: ["json2", "ds"],
+                    description: "문서 타입. document 파라미터 사용 시 필수. path 사용 시 확장자에서 자동 감지.",
+                },
+            },
+        },
+    },
     {
         name: "get_control_info",
         description: "MTSD 파일에서 컨트롤의 Name과 Type 매핑 정보를 추출합니다. TypeScript 스크립트 작성 시 컨트롤 변수의 타입을 확인하거나, import 문을 생성할 때 사용합니다.",
@@ -703,30 +811,49 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "get_element_types": {
                 const elementTypes = [
+                    // ── Display ──
                     { type: "Label", description: "텍스트 표시용 레이블" },
                     { type: "Button", description: "클릭 가능한 버튼" },
-                    { type: "DataGrid", description: "데이터 표시/편집용 그리드" },
-                    { type: "Group", description: "컨트롤을 그룹화하는 컨테이너" },
-                    { type: "Image", description: "이미지 표시" },
-                    { type: "RichTextBox", description: "서식있는 텍스트 편집기" },
-                    { type: "CheckBox", description: "체크박스 선택 컨트롤" },
-                    { type: "ComboBox", description: "드롭다운 선택 컨트롤" },
+                    { type: "Image", description: "이미지 표시 (내부적으로 WebImage)" },
+                    // ── Input ──
                     { type: "TextBox", description: "텍스트 입력 필드" },
+                    { type: "MaskTextBox", description: "마스크 텍스트 입력 (입력 패턴 지정)" },
                     { type: "NumberBox", description: "숫자 입력 필드" },
+                    { type: "RichTextBox", description: "서식있는 텍스트 편집기" },
+                    { type: "ComboBox", description: "드롭다운 선택 컨트롤" },
+                    { type: "MultiComboBox", description: "다중 선택 콤보박스" },
+                    { type: "PickList", description: "픽리스트 컨트롤" },
+                    { type: "CheckBox", description: "체크박스 선택 컨트롤" },
                     { type: "RadioButton", description: "라디오 버튼 선택" },
+                    { type: "Tree", description: "트리 체크박스 컨트롤" },
+                    { type: "ColorSelector", description: "색상 선택기" },
+                    { type: "Slider", description: "슬라이더 컨트롤" },
+                    { type: "Calendar", description: "달력 (날짜 선택)" },
+                    { type: "CalendarYear", description: "달력 (연도 선택)" },
+                    { type: "CalendarYM", description: "달력 (연월 선택)" },
+                    { type: "FileUploadButton", description: "파일 업로드 버튼" },
+                    // ── Grid ──
+                    { type: "DataGrid", description: "데이터 표시/편집용 그리드" },
+                    { type: "TreeGrid", description: "트리 구조 그리드" },
+                    { type: "OlapGrid", description: "OLAP 분석용 그리드" },
+                    { type: "iGrid", description: "인터랙티브 그리드 (MXGrid)" },
+                    { type: "CompactDataGrid", description: "컴팩트 데이터 그리드" },
+                    // ── TreeView ──
+                    { type: "TreeView", description: "트리뷰 (계층 구조 표시)" },
+                    // ── Chart ──
                     { type: "Chart", description: "차트 (막대, 선, 영역)" },
                     { type: "PieChart", description: "파이 차트" },
                     { type: "ScatterChart", description: "산점도 차트" },
-                    { type: "TreeGrid", description: "트리 구조 그리드" },
-                    { type: "OlapGrid", description: "OLAP 분석용 그리드" },
-                    { type: "Slider", description: "슬라이더 컨트롤" },
-                    { type: "FileUpload", description: "파일 업로드 컨트롤" },
-                    { type: "Browser", description: "웹 브라우저 컨트롤" },
-                    { type: "ColorPicker", description: "색상 선택기" },
-                    { type: "MultiComboBox", description: "다중 선택 콤보박스" },
-                    { type: "PickList", description: "픽리스트 컨트롤" },
+                    { type: "PolygonChart", description: "다각형/레이더 차트" },
+                    // ── Container / Layout ──
+                    { type: "Group", description: "컨트롤을 그룹화하는 컨테이너" },
+                    { type: "Tab", description: "탭 컨테이너 (탭 페이지별 자식 컨트롤)" },
+                    { type: "AddIn", description: "애드인 컨테이너" },
                     { type: "UserComponent", description: "보고서 컨테이너 (서브 보고서)" },
-                    { type: "ListGrid", description: "목록 그리드" },
+                    // ── Etc ──
+                    { type: "WebContainer", description: "웹 브라우저 컨테이너 (기본 이름: Browser)" },
+                    { type: "DiagramControl", description: "다이어그램 컨트롤" },
+                    { type: "Slicer", description: "슬라이서 컨트롤" },
                 ];
                 return {
                     content: [
@@ -962,6 +1089,184 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     };
                 }
             }
+            case "validate_mxgrid": {
+                let doc = args?.document;
+                const filePath = args?.path;
+                let docType = args?.type;
+                // 확장자로 타입 자동 감지
+                if (filePath && !docType) {
+                    if (filePath.endsWith(".json2"))
+                        docType = "json2";
+                    else if (filePath.endsWith(".ds"))
+                        docType = "ds";
+                    else {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        valid: false,
+                                        error: "파일 확장자가 .json2 또는 .ds가 아닙니다. type 파라미터를 지정해 주세요.",
+                                    }),
+                                },
+                            ],
+                        };
+                    }
+                }
+                // 파일 읽기
+                if (!doc && filePath) {
+                    try {
+                        const raw = readFileSync(filePath, "utf-8");
+                        doc = JSON.parse(raw);
+                    }
+                    catch (e) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        valid: false,
+                                        error: `파일 읽기/파싱 오류: ${e instanceof Error ? e.message : String(e)}`,
+                                    }),
+                                },
+                            ],
+                        };
+                    }
+                }
+                if (!doc) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: "path 또는 document 파라미터가 필요합니다." }),
+                            },
+                        ],
+                    };
+                }
+                if (!docType) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    error: "document 사용 시 type 파라미터('json2' 또는 'ds')가 필요합니다.",
+                                }),
+                            },
+                        ],
+                    };
+                }
+                // 문자열이면 파싱
+                if (typeof doc === "string") {
+                    try {
+                        doc = JSON.parse(doc);
+                    }
+                    catch (e) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        valid: false,
+                                        error: "JSON 파싱 오류: 유효한 JSON 형식이 아닙니다.",
+                                    }),
+                                },
+                            ],
+                        };
+                    }
+                }
+                // 검증기 선택
+                const validatorFn = docType === "json2" ? validateJson2 : validateDs;
+                const docTypeName = docType === "json2" ? "MX-GRID 템플릿(.json2)" : "MX-GRID 데이터셋(.ds)";
+                const isValid = validatorFn(doc);
+                if (isValid) {
+                    // 비즈니스 로직 경고
+                    const warnings = [];
+                    if (docType === "json2") {
+                        const json2Doc = doc;
+                        // 1. Style 참조 검증: Ranges에서 참조하는 스타일이 정의되어 있는지
+                        const definedStyles = new Set((json2Doc.Styles || []).map((s) => s.Name));
+                        for (const ws of json2Doc.WorkSheets || []) {
+                            for (const range of ws.Ranges || []) {
+                                if (typeof range.Style === "string" && !definedStyles.has(range.Style)) {
+                                    warnings.push(`WorkSheet "${ws.Name}" Range "${range.Range}": 스타일 "${range.Style}"이(가) Styles에 정의되어 있지 않습니다.`);
+                                }
+                            }
+                        }
+                        // 2. Names 시트 참조 검증
+                        const sheetNames = new Set((json2Doc.WorkSheets || []).map((ws) => ws.Name));
+                        for (const nameDef of json2Doc.Names || []) {
+                            if (nameDef.SheetName && !sheetNames.has(nameDef.SheetName)) {
+                                warnings.push(`Names "${nameDef.Name}": SheetName "${nameDef.SheetName}"이(가) WorkSheets에 존재하지 않습니다.`);
+                            }
+                        }
+                        // 3. DataBinding 시트 참조 검증
+                        for (const binding of json2Doc.DataBinding || []) {
+                            if (binding.Sheet && !sheetNames.has(binding.Sheet)) {
+                                warnings.push(`DataBinding "${binding.Name}": Sheet "${binding.Sheet}"이(가) WorkSheets에 존재하지 않습니다.`);
+                            }
+                        }
+                        // 4. 중복 Style 이름 검증
+                        const styleNames = (json2Doc.Styles || []).map((s) => s.Name);
+                        const seen = new Set();
+                        for (const name of styleNames) {
+                            if (seen.has(name)) {
+                                warnings.push(`Styles: 스타일 이름 "${name}"이(가) 중복 정의되어 있습니다.`);
+                            }
+                            seen.add(name);
+                        }
+                    }
+                    if (docType === "ds") {
+                        const dsDoc = doc;
+                        const datas = dsDoc.DataSources?.Datas || [];
+                        // 1. 중복 Id 검증
+                        const idSeen = new Set();
+                        for (const d of datas) {
+                            if (idSeen.has(d.Id)) {
+                                warnings.push(`DataSources.Datas: Id "${d.Id}"이(가) 중복되어 있습니다.`);
+                            }
+                            idSeen.add(d.Id);
+                        }
+                        // 2. 빈 SQL 경고
+                        for (let i = 0; i < datas.length; i++) {
+                            const d = datas[i];
+                            if (d.SQL !== undefined && d.SQL.trim() === "") {
+                                warnings.push(`DataSources.Datas[${i}] "${d.Name}": SQL이 비어 있습니다.`);
+                            }
+                        }
+                    }
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    valid: true,
+                                    message: `${docTypeName} 문서가 스키마를 준수합니다.`,
+                                    warnings: warnings.length > 0 ? warnings : undefined,
+                                }),
+                            },
+                        ],
+                    };
+                }
+                else {
+                    const errors = validatorFn.errors || [];
+                    const groupedErrors = groupErrors(errors);
+                    const errorCount = errors.length;
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    valid: false,
+                                    errorCount,
+                                    summary: `${errorCount}개의 오류가 발견되었습니다.`,
+                                    errors: groupedErrors,
+                                    rawErrors: errors.slice(0, 20).map(translateError),
+                                }),
+                            },
+                        ],
+                    };
+                }
+            }
             case "get_control_info": {
                 const filePath = args?.path;
                 if (!filePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bimatrix-aud-platform/aud_mcp_server",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "description": "MCP Server for i-AUD MTSD document validation and generation",
   "type": "module",
   "main": "dist/index.js",

package/schemas/ds.interface.ts

@@ -0,0 +1,68 @@
+/**
+ * MX-GRID 데이터셋(.ds) 파일 구조 인터페이스
+ * .ds 파일은 MX-GRID 스프레드시트의 데이터 바인딩 소스를 정의합니다.
+ */
+
+// ============================================
+// 루트 인터페이스
+// ============================================
+
+/**
+ * .ds 파일 최상위 구조
+ */
+export interface IDsDocument {
+  /** 데이터 소스 정의 */
+  DataSources: IDataSources;
+}
+
+/**
+ * 데이터 소스 컨테이너
+ */
+export interface IDataSources {
+  /** 데이터 소스 항목 배열 */
+  Datas: IDataItem[];
+}
+
+// ============================================
+// 데이터 소스 항목
+// ============================================
+
+/**
+ * 개별 데이터 소스 항목
+ */
+export interface IDataItem {
+  /** 데이터 소스 고유 ID */
+  Id: string;
+  /** 데이터 소스 이름 */
+  Name: string;
+  /** 데이터 출력 주소 (예: "'V1'!$A$2:$B$3") */
+  OutputAddress: string;
+  /** 설명 */
+  Description?: string;
+  /** 컬럼 헤더 출력 여부 */
+  WriterColumnHeader?: boolean;
+  /** 데이터베이스 연결 코드 */
+  ConnectionCode?: string;
+  /** 데이터베이스 연결 이름 */
+  ConnectionName?: string;
+  /** 데이터베이스 유형 코드 */
+  DBType?: number;
+  /** 소유자 코드 */
+  OwnerCode?: string;
+  /** 선택된 스키마 이름 */
+  SelectedSchemaName?: string;
+  /** 소스 유형 코드 */
+  SourceType?: number;
+  /** SQL 쿼리 */
+  SQL?: string;
+  /** i-META 배치 정보 (값이 있는 경우 수정 불가) */
+  MetaLayout?: string | null;
+  /** 바인딩용 SQL */
+  BindSQL?: string;
+  /** 마지막 수정일시 */
+  LastModifyDate?: string;
+  /** 서비스 ID */
+  ServiceID?: string;
+  /** 레코드 수 */
+  RecordCount?: number;
+}

package/schemas/ds.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "ds-file-schema",
+  "title": "MX-GRID DataSource Schema",
+  "description": "MX-GRID 데이터셋(.ds) 파일 스키마. 스프레드시트 데이터 바인딩 소스를 정의합니다.",
+  "type": "object",
+  "required": ["DataSources"],
+  "additionalProperties": false,
+  "properties": {
+    "DataSources": {
+      "type": "object",
+      "description": "데이터 소스 정의",
+      "required": ["Datas"],
+      "additionalProperties": false,
+      "properties": {
+        "Datas": {
+          "type": "array",
+          "description": "데이터 소스 항목 배열",
+          "items": { "$ref": "#/$defs/DataItem" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "DataItem": {
+      "type": "object",
+      "description": "개별 데이터 소스 항목",
+      "required": ["Id", "Name", "OutputAddress"],
+      "additionalProperties": true,
+      "properties": {
+        "Id": {
+          "type": "string",
+          "description": "데이터 소스 고유 ID"
+        },
+        "Name": {
+          "type": "string",
+          "description": "데이터 소스 이름"
+        },
+        "OutputAddress": {
+          "type": "string",
+          "description": "데이터 출력 주소 (예: \"'V1'!$A$2:$B$3\")"
+        },
+        "Description": {
+          "type": ["string", "null"],
+          "description": "설명"
+        },
+        "WriterColumnHeader": {
+          "type": "boolean",
+          "description": "컬럼 헤더 출력 여부"
+        },
+        "ConnectionCode": {
+          "type": "string",
+          "description": "데이터베이스 연결 코드"
+        },
+        "ConnectionName": {
+          "type": "string",
+          "description": "데이터베이스 연결 이름"
+        },
+        "DBType": {
+          "type": "integer",
+          "description": "데이터베이스 유형 코드"
+        },
+        "OwnerCode": {
+          "type": "string",
+          "description": "소유자 코드"
+        },
+        "SelectedSchemaName": {
+          "type": ["string", "null"],
+          "description": "선택된 스키마 이름"
+        },
+        "SourceType": {
+          "type": "integer",
+          "description": "소스 유형 코드"
+        },
+        "SQL": {
+          "type": "string",
+          "description": "SQL 쿼리"
+        },
+        "MetaLayout": {
+          "type": ["string", "null"],
+          "description": "i-META 배치 정보 (값이 있는 경우 수정 불가)"
+        },
+        "BindSQL": {
+          "type": "string",
+          "description": "바인딩용 SQL"
+        },
+        "LastModifyDate": {
+          "type": "string",
+          "description": "마지막 수정일시"
+        },
+        "ServiceID": {
+          "type": "string",
+          "description": "서비스 ID"
+        },
+        "RecordCount": {
+          "type": "integer",
+          "description": "레코드 수"
+        }
+      }
+    }
+  }
+}