@bimatrix-aud-platform/aud_mcp_server 1.1.0 → 1.1.2

package/dist/generators/control-info.d.ts

@@ -0,0 +1,17 @@
+export interface ControlEntry {
+    Name: string;
+    Type: string;
+    InGroup: string | null;
+}
+export interface ControlInfoResult {
+    success: boolean;
+    controls: ControlEntry[];
+    imports: string[];
+    errors: string[];
+}
+/**
+ * MTSD 파일에서 컨트롤 Name → Type 매핑을 추출합니다.
+ * @param filePath MTSD 파일 경로
+ * @param filterName 특정 컨트롤만 조회 (생략 시 전체)
+ */
+export declare function getControlInfo(filePath: string, filterName?: string): ControlInfoResult;

package/dist/generators/control-info.js

@@ -0,0 +1,89 @@
+import { readFileSync } from "fs";
+// MTSD Type → TypeScript import 매핑 (예외 케이스만 정의)
+const TYPE_TO_IMPORT = {
+    MXGrid: { importName: "iGrid", importPath: "@AUD_CLIENT/control/iGrid" },
+};
+/**
+ * MTSD 파일에서 컨트롤 Name → Type 매핑을 추출합니다.
+ * @param filePath MTSD 파일 경로
+ * @param filterName 특정 컨트롤만 조회 (생략 시 전체)
+ */
+export function getControlInfo(filePath, filterName) {
+    const errors = [];
+    // 1. 파일 읽기
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf-8");
+    }
+    catch (e) {
+        return {
+            success: false,
+            controls: [],
+            imports: [],
+            errors: [
+                `파일을 읽을 수 없습니다: ${e instanceof Error ? e.message : String(e)}`,
+            ],
+        };
+    }
+    let doc;
+    try {
+        doc = JSON.parse(raw);
+    }
+    catch (e) {
+        return {
+            success: false,
+            controls: [],
+            imports: [],
+            errors: ["JSON 파싱 오류: 유효한 JSON 형식이 아닙니다."],
+        };
+    }
+    // 2. Elements 트리 순회하여 컨트롤 수집
+    const controls = [];
+    const typeSet = new Set();
+    function walkElements(elements, parentGroup) {
+        for (const el of elements) {
+            const name = el.Name || "";
+            const type = el.Type || "";
+            const inGroup = el.InGroup || parentGroup;
+            if (name && type) {
+                // filterName이 지정된 경우 해당 이름만 수집
+                if (!filterName || name === filterName) {
+                    controls.push({ Name: name, Type: type, InGroup: inGroup });
+                    typeSet.add(type);
+                }
+            }
+            // ChildElements 재귀 순회
+            if (el.ChildElements && Array.isArray(el.ChildElements)) {
+                walkElements(el.ChildElements, type === "Group" ? name : parentGroup);
+            }
+        }
+    }
+    // Forms > Elements 순회
+    const forms = doc.Forms || [];
+    for (const form of forms) {
+        const elements = form.Elements || [];
+        walkElements(elements, null);
+    }
+    // 최상위 Elements (Forms 없는 구조)
+    if (doc.Elements && Array.isArray(doc.Elements)) {
+        walkElements(doc.Elements, null);
+    }
+    // 3. import 문 생성
+    const imports = [];
+    const sortedTypes = Array.from(typeSet).sort();
+    for (const type of sortedTypes) {
+        const mapping = TYPE_TO_IMPORT[type];
+        if (mapping) {
+            imports.push(`import { ${mapping.importName} } from "${mapping.importPath}";`);
+        }
+        else {
+            imports.push(`import { ${type} } from "@AUD_CLIENT/control/${type}";`);
+        }
+    }
+    return {
+        success: true,
+        controls,
+        imports,
+        errors,
+    };
+}

package/dist/generators/fixer.js

@@ -43,13 +43,15 @@ export function fixMtsd(filePath) {
     // 3. 보정 규칙 적용
     // Rule 1: DataSource Name→Id 참조 보정
     fixDataSourceReferences(doc, dsNameToId, dsIdSet, fixes);
-    // Rule 2: DataSource Params에 Value 누락 보정
+    // Rule 2: OlapGrid DataSource 기반 Fields 자동 생성
+    fixOlapGridFields(doc, datas, fixes);
+    // Rule 3: DataSource Params에 Value 누락 보정
     //fixParamsMissingValue(datas, fixes);
-    // Rule 3: DataSource Columns에 Type 누락 보정
+    // Rule 4: DataSource Columns에 Type 누락 보정
     //fixColumnsMissingType(datas, fixes);
-    // Rule 4: Element Position.Docking 필수 속성 보정
+    // Rule 5: Element Position.Docking 필수 속성 보정
     //fixDockingDefaults(doc, fixes);
-    // Rule 5: Element Style.Border 필수 속성 보정
+    // Rule 6: Element Style.Border 필수 속성 보정
     //fixBorderDefaults(doc, fixes);
     // 4. 파일 저장
     if (fixes.length > 0) {
@@ -89,7 +91,166 @@ function fixDataSourceReferences(doc, dsNameToId, dsIdSet, fixes) {
         });
     }
 }
-// ---- Rule 2: Params Value 누락 보정 ----
+// ---- Rule 2: OlapGrid DataSource 기반 Fields 자동 생성 ----
+// DataSource Column.Type이 "Numeric"이면 숫자형으로 판단
+const NUMERIC_COLUMN_TYPES = new Set([
+    "Numeric",
+    // SQL 타입 호환
+    "INT", "INTEGER", "BIGINT", "SMALLINT", "TINYINT",
+    "NUMERIC", "DECIMAL", "FLOAT", "DOUBLE", "REAL", "NUMBER", "MONEY",
+]);
+function isNumericColumnType(type) {
+    return NUMERIC_COLUMN_TYPES.has(type) || NUMERIC_COLUMN_TYPES.has(type.toUpperCase());
+}
+/** OlapField 기본값 생성 (OlapField constructor + Serialize 기준) */
+function createDefaultOlapField(key, caption) {
+    return {
+        Key: key,
+        Caption: caption,
+        ToolTipField: "",
+        ToolTipText: "",
+        Category: 1, // enCategory.Dimension
+        Area: 0, // enArea.Hidden
+        SummaryType: 0, // enSummaryType.None
+        TotalSummaryType: 0,
+        SummaryVariation: 0,
+        GroupByType: 0, // enGroupByType.Auto
+        Format: "",
+        Formula: "",
+        Formula2: "",
+        RefFormula: "",
+        Width: 100,
+        Unit: 1,
+        CreateType: 0, // enOlapFieldCreateType.Default
+        SortType: 0, // enSortType.None
+        MeasureSortField: "",
+        SortBaseField: "",
+        MoveAble: true,
+        SortAble: true,
+        FilterAble: true,
+        AllowFilter: true,
+        AllowRow: true,
+        AllowColumn: true,
+        AllowData: true,
+        KeyType: 0, // enKeyType.None
+        DataType: 0, // enDataType.Numeric
+        SaveMode: 0, // enSaveMode.All
+        LanguageCode: "",
+        UseChartSource: true,
+        VisibleSubTotal: true,
+        SummaryBaseFieldKey: "",
+        TextAlignment: 1, // enHorizonAlign.Right
+        HeaderAlignment: 0, // enHorizonAlign.Left
+        InDimensions: "",
+        Visible: true,
+        Expanded: true,
+        MetaItemCode: "",
+        MetaItemName: "",
+        MetaRollupType: 0,
+        MetaCalculatorField: false,
+        MetaSummaryTypeIsDistinct: false,
+        FilterInfo: {
+            FilterType: 0, // enOlapFilterType.In
+            FilterKind: 0, // enOlapFilterKind.Dimension
+            HasMeasureFilter: false,
+            MeasureFilterTypeA: 0, // enOlapMeasureFilterType.Equals
+            MeasureFilterTypeB: 0,
+            MeasureAndOrOperator: 2, // enAndOrOperator.And
+        },
+    };
+}
+function fixOlapGridFields(doc, datas, fixes) {
+    // DataSource Id → DataSource 객체 매핑
+    const dsById = new Map();
+    for (const ds of datas) {
+        if (ds.Id)
+            dsById.set(ds.Id, ds);
+    }
+    const forms = doc.Forms || [];
+    for (const form of forms) {
+        const elements = form.Elements || [];
+        walkElements(elements, (el, path) => {
+            // OlapGrid 타입만 대상
+            if (el.Type !== "OlapGrid")
+                return;
+            // DataSource가 설정되어 있어야 함
+            if (!el.DataSource)
+                return;
+            // iOLAPView.Fields가 이미 존재하고 비어있지 않으면 스킵
+            const fields = el.iOLAPView?.Fields;
+            if (fields && Array.isArray(fields) && fields.length > 0)
+                return;
+            // 해당 DataSource 찾기
+            const ds = dsById.get(el.DataSource);
+            if (!ds)
+                return;
+            const columns = ds.Columns || [];
+            if (columns.length === 0)
+                return;
+            // Fields 생성
+            const newFields = [];
+            for (const col of columns) {
+                const colName = col.Name || "";
+                const caption = col.Caption || colName;
+                const field = createDefaultOlapField(colName, caption);
+                if (isNumericColumnType(col.Type || "")) {
+                    // Measure 필드
+                    field.Category = 2; // enCategory.Measure
+                    field.Format = "{0:N0}";
+                    field.DataType = 0; // enDataType.Numeric
+                    field.SummaryType = 1; // enSummaryType.Sum
+                    field.TextAlignment = 1; // enHorizonAlign.Right
+                }
+                else {
+                    // Dimension 필드
+                    field.Category = 1; // enCategory.Dimension
+                    field.DataType = 1; // enDataType.String
+                    field.SortType = 1; // enSortType.Asc
+                    field.SummaryType = 5; // enSummaryType.Count
+                    field.TextAlignment = 1; // enHorizonAlign.Right
+                }
+                newFields.push(field);
+            }
+            // Area 자동 배치 (setDataSource 로직 준용)
+            let rowCnt = 0;
+            let colCnt = 0;
+            let dataCnt = 0;
+            for (const field of newFields) {
+                if (field.DataType === 0) {
+                    // Numeric → Data 영역 (최대 3개), 나머지 Filter
+                    if (dataCnt < 3) {
+                        field.Area = 4; // enArea.Data
+                        dataCnt++;
+                    }
+                    else {
+                        field.Area = 3; // enArea.Filter
+                    }
+                }
+                else {
+                    // String → Row(최대 2개) → Column(최대 2개) → Filter
+                    if (rowCnt < 2) {
+                        field.Area = 1; // enArea.Row
+                        rowCnt++;
+                    }
+                    else if (colCnt < 2) {
+                        field.Area = 2; // enArea.Column
+                        colCnt++;
+                    }
+                    else {
+                        field.Area = 3; // enArea.Filter
+                    }
+                }
+            }
+            // iOLAPView 구조 생성/보정
+            if (!el.iOLAPView) {
+                el.iOLAPView = {};
+            }
+            el.iOLAPView.Fields = newFields;
+            fixes.push(`[Rule2] ${path}: DataSource "${ds.Name || ds.Id}" 컬럼 기준 OlapGrid Fields ${newFields.length}개 자동 생성`);
+        });
+    }
+}
+// ---- Rule 3: Params Value 누락 보정 ----
 // function fixParamsMissingValue(datas: any[], fixes: string[]) {
 //   for (const ds of datas) {
 //     const params: any[] = ds.Params || [];

package/dist/index.js

@@ -11,6 +11,7 @@ import { generateElement } from "./generators/element.js";
 import { generateGridColumns } from "./generators/grid-column.js";
 import { generateDataSource } from "./generators/datasource.js";
 import { fixMtsd } from "./generators/fixer.js";
+import { getControlInfo } from "./generators/control-info.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Load MTSD schema
@@ -409,6 +410,24 @@ const tools = [
             required: ["path"],
         },
     },
+    {
+        name: "get_control_info",
+        description: "MTSD 파일에서 컨트롤의 Name과 Type 매핑 정보를 추출합니다. TypeScript 스크립트 작성 시 컨트롤 변수의 타입을 확인하거나, import 문을 생성할 때 사용합니다.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "MTSD 파일의 전체 경로 (예: C:/reports/sample/sample.mtsd)",
+                },
+                name: {
+                    type: "string",
+                    description: "특정 컨트롤 이름 (생략 시 전체 컨트롤 목록 반환)",
+                },
+            },
+            required: ["path"],
+        },
+    },
 ];
 // Create MCP server
 const server = new Server({
@@ -714,6 +733,29 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "get_control_info": {
+                const filePath = args?.path;
+                if (!filePath) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: "path 파라미터가 필요합니다." }),
+                            },
+                        ],
+                    };
+                }
+                const filterName = args?.name;
+                const result = getControlInfo(filePath, filterName);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
             default:
                 return {
                     content: [
@@ -742,7 +784,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("MCP MTSD Validator server started");
+    console.error("i-AUD MCP server started");
 }
 main().catch((error) => {
     console.error("Server error:", error);

package/package.json

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