@bimatrix-aud-platform/aud_mcp_server 1.0.0 → 1.1.1

package/dist/generators/fixer.d.ts

@@ -0,0 +1,10 @@
+export interface FixResult {
+    fixed: boolean;
+    fixCount: number;
+    fixes: string[];
+    errors: string[];
+}
+/**
+ * MTSD 파일을 읽고, 자동 보정 규칙을 적용한 뒤, 파일을 덮어씁니다.
+ */
+export declare function fixMtsd(filePath: string): FixResult;

package/dist/generators/fixer.js

@@ -0,0 +1,346 @@
+import { readFileSync, writeFileSync } from "fs";
+/**
+ * MTSD 파일을 읽고, 자동 보정 규칙을 적용한 뒤, 파일을 덮어씁니다.
+ */
+export function fixMtsd(filePath) {
+    const fixes = [];
+    const errors = [];
+    // 1. 파일 읽기
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf-8");
+    }
+    catch (e) {
+        return {
+            fixed: false,
+            fixCount: 0,
+            fixes: [],
+            errors: [`파일을 읽을 수 없습니다: ${e instanceof Error ? e.message : String(e)}`],
+        };
+    }
+    let doc;
+    try {
+        doc = JSON.parse(raw);
+    }
+    catch (e) {
+        return {
+            fixed: false,
+            fixCount: 0,
+            fixes: [],
+            errors: ["JSON 파싱 오류: 유효한 JSON 형식이 아닙니다."],
+        };
+    }
+    // 2. DataSource Name→Id 매핑 구성
+    const dsNameToId = new Map();
+    const dsIdSet = new Set();
+    const datas = doc.DataSources?.Datas || [];
+    for (const ds of datas) {
+        if (ds.Id && ds.Name) {
+            dsNameToId.set(ds.Name, ds.Id);
+            dsIdSet.add(ds.Id);
+        }
+    }
+    // 3. 보정 규칙 적용
+    // Rule 1: DataSource Name→Id 참조 보정
+    fixDataSourceReferences(doc, dsNameToId, dsIdSet, fixes);
+    // Rule 2: OlapGrid DataSource 기반 Fields 자동 생성
+    fixOlapGridFields(doc, datas, fixes);
+    // Rule 3: DataSource Params에 Value 누락 보정
+    //fixParamsMissingValue(datas, fixes);
+    // Rule 4: DataSource Columns에 Type 누락 보정
+    //fixColumnsMissingType(datas, fixes);
+    // Rule 5: Element Position.Docking 필수 속성 보정
+    //fixDockingDefaults(doc, fixes);
+    // Rule 6: Element Style.Border 필수 속성 보정
+    //fixBorderDefaults(doc, fixes);
+    // 4. 파일 저장
+    if (fixes.length > 0) {
+        try {
+            writeFileSync(filePath, JSON.stringify(doc, null, 2), "utf-8");
+        }
+        catch (e) {
+            errors.push(`파일 저장 실패: ${e instanceof Error ? e.message : String(e)}`);
+            return { fixed: false, fixCount: fixes.length, fixes, errors };
+        }
+    }
+    return {
+        fixed: fixes.length > 0,
+        fixCount: fixes.length,
+        fixes,
+        errors,
+    };
+}
+// ---- Rule 1: DataSource 참조 보정 ----
+function fixDataSourceReferences(doc, dsNameToId, dsIdSet, fixes) {
+    const forms = doc.Forms || [];
+    for (const form of forms) {
+        const elements = form.Elements || [];
+        walkElements(elements, (el, path) => {
+            if (el.DataSource && typeof el.DataSource === "string") {
+                const val = el.DataSource;
+                // 이미 올바른 Id인 경우 스킵
+                if (dsIdSet.has(val))
+                    return;
+                // Name으로 참조한 경우 Id로 보정
+                const correctId = dsNameToId.get(val);
+                if (correctId) {
+                    el.DataSource = correctId;
+                    fixes.push(`[Rule1] ${path}.DataSource: Name "${val}" → Id "${correctId}" 보정`);
+                }
+            }
+        });
+    }
+}
+// ---- 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 || [];
+//     for (const param of params) {
+//       if (!("Value" in param)) {
+//         param.Value = "";
+//         fixes.push(
+//           `[Rule2] DataSource "${ds.Name}".Params "${param.Name}": Value 속성 추가 ("")`
+//         );
+//       }
+//     }
+//   }
+// }
+// ---- Rule 3: Columns Type 누락 보정 ----
+// function fixColumnsMissingType(datas: any[], fixes: string[]) {
+//   for (const ds of datas) {
+//     const columns: any[] = ds.Columns || [];
+//     for (const col of columns) {
+//       if (!("Type" in col)) {
+//         col.Type = "string";
+//         fixes.push(
+//           `[Rule3] DataSource "${ds.Name}".Columns "${col.Name}": Type 속성 추가 ("string")`
+//         );
+//       }
+//     }
+//   }
+// }
+// ---- Rule 4: Docking 필수 속성 보정 ----
+const DOCKING_DEFAULTS = {
+    Left: false,
+    Right: false,
+    Top: false,
+    Bottom: false,
+    Margin: "0,0,0,0",
+    HoldSize: false,
+    MinWidth: 0,
+    MinHeight: 0,
+};
+// function fixDockingDefaults(doc: any, fixes: string[]) {
+//   const forms: any[] = doc.Forms || [];
+//   for (const form of forms) {
+//     const elements: any[] = form.Elements || [];
+//     walkElements(elements, (el, path) => {
+//       const docking = el.Position?.Docking;
+//       if (!docking) return;
+//       for (const [key, defaultVal] of Object.entries(DOCKING_DEFAULTS)) {
+//         if (!(key in docking)) {
+//           docking[key] = defaultVal;
+//           fixes.push(
+//             `[Rule4] ${path}.Position.Docking.${key}: 누락 속성 추가 (${JSON.stringify(defaultVal)})`
+//           );
+//         }
+//       }
+//     });
+//   }
+// }
+// ---- Rule 5: Border 필수 속성 보정 ----
+const BORDER_DEFAULTS = {
+    CornerRadius: "0,0,0,0",
+    LineType: "none",
+    Thickness: "0,0,0,0",
+};
+// function fixBorderDefaults(doc: any, fixes: string[]) {
+//   const forms: any[] = doc.Forms || [];
+//   for (const form of forms) {
+//     const elements: any[] = form.Elements || [];
+//     walkElements(elements, (el, path) => {
+//       const border = el.Style?.Border;
+//       if (!border) return;
+//       for (const [key, defaultVal] of Object.entries(BORDER_DEFAULTS)) {
+//         if (!(key in border)) {
+//           border[key] = defaultVal;
+//           fixes.push(
+//             `[Rule5] ${path}.Style.Border.${key}: 누락 속성 추가 ("${defaultVal}")`
+//           );
+//         }
+//       }
+//     });
+//   }
+// }
+// ---- 유틸: Element 트리 순회 ----
+function walkElements(elements, callback, parentPath = "") {
+    for (const el of elements) {
+        const path = parentPath
+            ? `${parentPath} > ${el.Type || "?"}(${el.Name || el.Id || "?"})`
+            : `${el.Type || "?"}(${el.Name || el.Id || "?"})`;
+        callback(el, path);
+        // Group의 ChildElements 재귀 순회
+        if (el.ChildElements && Array.isArray(el.ChildElements)) {
+            walkElements(el.ChildElements, callback, path);
+        }
+    }
+}

package/dist/index.js

@@ -10,6 +10,7 @@ import { dirname, join } from "path";
 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";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Load MTSD schema
@@ -394,6 +395,20 @@ const tools = [
             additionalProperties: true,
         },
     },
+    {
+        name: "fix_mtsd",
+        description: "MTSD 파일을 읽어 자동 보정 규칙을 적용하고 파일을 덮어씁니다. DataSource Name→Id 참조 보정, Params Value 누락 보정, Columns Type 누락 보정, Docking/Border 필수 속성 보정을 수행합니다.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "MTSD 파일의 전체 경로 (예: C:/reports/sample/sample.mtsd)",
+                },
+            },
+            required: ["path"],
+        },
+    },
 ];
 // Create MCP server
 const server = new Server({
@@ -677,6 +692,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "fix_mtsd": {
+                const filePath = args?.path;
+                if (!filePath) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ error: "path 파라미터가 필요합니다." }),
+                            },
+                        ],
+                    };
+                }
+                const result = fixMtsd(filePath);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
             default:
                 return {
                     content: [
@@ -705,7 +742,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.0.0",
+  "version": "1.1.1",
   "description": "MCP Server for i-AUD MTSD document validation and generation",
   "type": "module",
   "main": "dist/index.js",