@bimatrix-aud-platform/aud_mcp_server 1.0.0

package/README.md

@@ -0,0 +1,128 @@
+# @bimatrix-aud-platform/mcp-mtsd-validator
+
+MTSD (i-AUD 화면 UI 정의 JSON) 문서를 검증하기 위한 MCP(Model Context Protocol) Server입니다.
+
+Claude AI가 MTSD 문서를 생성할 때 실시간으로 스키마 검증을 수행하여 정확한 문서를 만들 수 있도록 도와줍니다.
+
+## 설치 및 등록
+
+### 방법 1: npx로 바로 사용 (권장)
+
+별도 설치 없이 MCP 설정에 다음을 추가합니다.
+
+**Claude Code 프로젝트 설정** (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "mtsd-validator": {
+      "command": "npx",
+      "args": ["-y", "@bimatrix-aud-platform/mcp-mtsd-validator"]
+    }
+  }
+}
+```
+
+**Claude Desktop 전역 설정** (`%APPDATA%\Claude\claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mtsd-validator": {
+      "command": "npx",
+      "args": ["-y", "@bimatrix-aud-platform/mcp-mtsd-validator"]
+    }
+  }
+}
+```
+
+### 방법 2: 글로벌 설치 후 사용
+
+```bash
+npm install -g @bimatrix-aud-platform/mcp-mtsd-validator
+```
+
+MCP 설정:
+
+```json
+{
+  "mcpServers": {
+    "mtsd-validator": {
+      "command": "mcp-mtsd-validator"
+    }
+  }
+}
+```
+
+### 방법 3: 로컬 설치
+
+```bash
+npm install @bimatrix-aud-platform/mcp-mtsd-validator
+```
+
+MCP 설정:
+
+```json
+{
+  "mcpServers": {
+    "mtsd-validator": {
+      "command": "node",
+      "args": ["node_modules/@bimatrix-aud-platform/mcp-mtsd-validator/dist/index.js"]
+    }
+  }
+}
+```
+
+## 제공 도구
+
+### validate_mtsd
+전체 MTSD 문서를 검증합니다.
+
+```
+입력: { document: <JSON 문자열 또는 객체> }
+출력: { valid: boolean, errors?: [...] }
+```
+
+### validate_part
+특정 부분만 검증합니다 (점진적 생성 시 유용).
+
+```
+입력: { partName: "Form", data: <JSON> }
+출력: { valid: boolean, errors?: [...] }
+
+partName 예시:
+- ReportInfo, DataSource, Form, Element
+- LabelElement, ButtonElement, DataGridElement
+- Variable, Module, ExecutionPlan
+```
+
+### get_schema_info
+특정 타입의 스키마 정보를 조회합니다.
+
+```
+입력: { typeName: "Form" }
+출력: { required: [...], optional: [...], properties: {...} }
+```
+
+### get_element_types
+사용 가능한 Element 타입 목록을 반환합니다.
+
+### get_root_structure
+MTSD 문서의 최상위 구조를 반환합니다.
+
+## 사용 예시
+
+Claude에게 MTSD 문서 생성을 요청할 때:
+
+1. `get_root_structure`로 전체 구조 파악
+2. `get_schema_info`로 각 섹션의 필수/선택 속성 확인
+3. 부분별로 생성 후 `validate_part`로 즉시 검증
+4. 전체 완성 후 `validate_mtsd`로 최종 검증
+
+## 요구사항
+
+- Node.js >= 18.0.0
+
+## 라이선스
+
+MIT

package/dist/generators/datasource.d.ts

@@ -0,0 +1,19 @@
+export interface DataSourceInput {
+    name: string;
+    connection: string;
+    sql?: string;
+    params?: string[];
+    columns?: Array<{
+        name: string;
+        type?: string;
+    }>;
+    dsType?: number;
+    useMeta?: boolean;
+    useCache?: boolean;
+    encrypted?: boolean;
+    [key: string]: any;
+}
+export declare function generateDataSource(input: DataSourceInput): {
+    dataSource: Record<string, any>;
+    warnings: string[];
+};

package/dist/generators/datasource.js

@@ -0,0 +1,72 @@
+import { generateId } from "../utils/uuid.js";
+const PROCESSED_KEYS = new Set([
+    "name",
+    "connection",
+    "sql",
+    "params",
+    "columns",
+    "dsType",
+    "useMeta",
+    "useCache",
+    "encrypted",
+]);
+/**
+ * SQL 텍스트에서 파라미터 이름 자동 추출
+ * 패턴: @:PARAM, :PARAM, %:PARAM
+ */
+function extractParamsFromSQL(sql) {
+    const paramSet = new Set();
+    const regex = /[@%]?:([A-Za-z_][A-Za-z0-9_]*)/g;
+    let match;
+    while ((match = regex.exec(sql)) !== null) {
+        paramSet.add(match[1]);
+    }
+    return Array.from(paramSet);
+}
+export function generateDataSource(input) {
+    const warnings = [];
+    const id = generateId("DS");
+    // 파라미터 추출
+    let paramNames = [];
+    if (input.params && input.params.length > 0) {
+        paramNames = input.params;
+    }
+    else if (input.sql) {
+        paramNames = extractParamsFromSQL(input.sql);
+        if (paramNames.length > 0) {
+            warnings.push(`SQL에서 ${paramNames.length}개의 파라미터를 자동 추출했습니다: ${paramNames.join(", ")}`);
+        }
+    }
+    // Params 배열 (스키마: Name, Value 필수)
+    const params = paramNames.map((name) => ({
+        Name: name.startsWith(":") ? name : `:${name}`,
+        Value: "",
+    }));
+    // Columns 배열 (스키마: Name, Type 필수)
+    const columns = (input.columns || []).map((col) => ({
+        Name: col.name,
+        Type: col.type || "string",
+    }));
+    const dataSource = {
+        Id: id,
+        Name: input.name,
+        UseMeta: input.useMeta, //? "True" : "False",
+        UseCache: input.useCache, // ? "True" : "False",
+        ConnectionCode: input.connection,
+        Encrypted: input.encrypted, //? "True" : "False",
+        DSType: input.dsType ?? 0,
+        SQL: input.sql || "",
+        Params: params,
+        Columns: columns,
+    };
+    // 나머지 pass-through
+    for (const [key, value] of Object.entries(input)) {
+        if (!PROCESSED_KEYS.has(key)) {
+            const schemaKey = key.charAt(0).toUpperCase() + key.slice(1);
+            if (!(schemaKey in dataSource)) {
+                dataSource[schemaKey] = value;
+            }
+        }
+    }
+    return { dataSource, warnings };
+}

package/dist/generators/defaults.d.ts

@@ -0,0 +1,163 @@
+export declare function defaultColor(): {
+    R: number;
+    G: number;
+    B: number;
+    A: number;
+};
+export declare function defaultBackground(): {};
+export declare function defaultBorder(): {
+    CornerRadius: string;
+    LineType: "none";
+    Thickness: string;
+};
+export declare function defaultFont(): {
+    Color: {
+        R: number;
+        G: number;
+        B: number;
+        A: number;
+    };
+    Size: number;
+    Family: string;
+    Bold: boolean;
+    Italic: boolean;
+    UnderLine: boolean;
+    HorizontalAlignment: "left";
+    VerticalAlignment: "middle";
+};
+export declare function defaultDocking(): {
+    Left: boolean;
+    Right: boolean;
+    Top: boolean;
+    Bottom: boolean;
+    Margin: string;
+    HoldSize: boolean;
+    MinWidth: number;
+    MinHeight: number;
+};
+export declare function defaultPosition(): {
+    Left: number;
+    Top: number;
+    Width: number;
+    Height: number;
+    ZIndex: number;
+    TabIndex: number;
+    Docking: {
+        Left: boolean;
+        Right: boolean;
+        Top: boolean;
+        Bottom: boolean;
+        Margin: string;
+        HoldSize: boolean;
+        MinWidth: number;
+        MinHeight: number;
+    };
+};
+export declare function defaultStyle(): {
+    Type: number;
+    BoxStyle: string;
+    Background: {};
+    Border: {
+        CornerRadius: string;
+        LineType: "none";
+        Thickness: string;
+    };
+};
+export declare function defaultValidator(): {
+    ValidateType: number;
+    UseGuideMessage: boolean;
+    GuideLanguageCode: string;
+    UseErrorMessage: boolean;
+    ErrorLanguageCode: string;
+};
+export declare function labelDefaults(): {
+    LanguageCode: string;
+    Text: string;
+    Cursor: string;
+    Formula: string;
+    UseTextOverflow: boolean;
+    UseAutoLineBreak: boolean;
+    LineSpacing: number;
+    HasLineSpacing: boolean;
+    MxBinding: string;
+    MxBindingUseStyle: boolean;
+};
+export declare function buttonDefaults(): {
+    LanguageCode: string;
+    Value: string;
+    Cursor: string;
+    HasNewRadius: boolean;
+};
+export declare function dataGridDefaults(): {
+    CellMargin: string;
+    Columns: any[];
+    UsePPTExport: boolean;
+};
+export declare function groupDefaults(): {
+    ChildElements: any[];
+};
+export declare function checkBoxDefaults(): {
+    LanguageCode: string;
+    Text: string;
+    TextPosition: string;
+    GroupName: string;
+    CheckedValue: string;
+    UnCheckedValue: string;
+    Checked: boolean;
+    ViewType: number;
+};
+export declare function comboBoxDefaults(): {
+    DataSource: string;
+    Value: string;
+    Text: string;
+    InitType: number;
+    RefreshType: number;
+    IsReadOnly: boolean;
+    SortType: number;
+    AutoRefresh: boolean;
+    AfterRefresh: string;
+    UseAllItems: boolean;
+    UseAllItemsText: string;
+    DisplayType: number;
+    DataSourceInfo: {
+        LabelField: string;
+        ValueField: string;
+    };
+    InitValue: string;
+};
+export declare function textBoxDefaults(): Record<string, any>;
+export declare function numberBoxDefaults(): {
+    Format: string;
+    Formula: string;
+    Value: number;
+    Text: string;
+    IsReadOnly: boolean;
+    Maximum: number;
+    Minimum: number;
+    MxBinding: string;
+    MxBindingUseStyle: boolean;
+};
+export declare function imageDefaults(): {
+    Cursor: string;
+    Image: {
+        FolderCode: string;
+        SaveName: string;
+    };
+};
+export declare function richTextBoxDefaults(): {
+    Formula: string;
+    IsReadOnly: boolean;
+    MaxLength: number;
+    LineSpacing: number;
+    HasLineSpacing: boolean;
+    MxBinding: string;
+    MxBindingUseStyle: boolean;
+    Value: string;
+    Text: string;
+};
+export declare function userComponentDefaults(): {
+    DoRefresh: boolean;
+    DoExport: boolean;
+    ReportInfo: {};
+};
+export declare const ELEMENT_DEFAULTS_MAP: Record<string, () => Record<string, any>>;

package/dist/generators/defaults.js

@@ -0,0 +1,187 @@
+// ---- Base structural defaults ----
+export function defaultColor() {
+    return { R: 0, G: 0, B: 0, A: 255 };
+}
+export function defaultBackground() {
+    return {};
+}
+export function defaultBorder() {
+    return {
+        CornerRadius: "0,0,0,0",
+        LineType: "none",
+        Thickness: "0,0,0,0",
+    };
+}
+export function defaultFont() {
+    return {
+        Color: { R: 0, G: 0, B: 0, A: 255 },
+        Size: 12,
+        Family: "Malgun Gothic",
+        Bold: false,
+        Italic: false,
+        UnderLine: false,
+        HorizontalAlignment: "left",
+        VerticalAlignment: "middle",
+    };
+}
+export function defaultDocking() {
+    return {
+        Left: false,
+        Right: false,
+        Top: false,
+        Bottom: false,
+        Margin: "0,0,0,0",
+        HoldSize: false,
+        MinWidth: 0,
+        MinHeight: 0,
+    };
+}
+export function defaultPosition() {
+    return {
+        Left: 0,
+        Top: 0,
+        Width: 100,
+        Height: 30,
+        ZIndex: 1,
+        TabIndex: 0,
+        Docking: defaultDocking(),
+    };
+}
+export function defaultStyle() {
+    return {
+        Type: 0,
+        BoxStyle: "",
+        Background: defaultBackground(),
+        Border: defaultBorder(),
+    };
+}
+export function defaultValidator() {
+    return {
+        ValidateType: 0,
+        UseGuideMessage: false,
+        GuideLanguageCode: "",
+        UseErrorMessage: false,
+        ErrorLanguageCode: "",
+    };
+}
+// ---- Element 타입별 기본값 ----
+export function labelDefaults() {
+    return {
+        LanguageCode: "",
+        Text: "",
+        Cursor: "default",
+        Formula: "",
+        UseTextOverflow: false,
+        UseAutoLineBreak: false,
+        LineSpacing: 0,
+        HasLineSpacing: false,
+        MxBinding: "",
+        MxBindingUseStyle: false,
+    };
+}
+export function buttonDefaults() {
+    return {
+        LanguageCode: "",
+        Value: "",
+        Cursor: "pointer",
+        HasNewRadius: false,
+    };
+}
+export function dataGridDefaults() {
+    return {
+        CellMargin: "2",
+        Columns: [],
+        UsePPTExport: false,
+    };
+}
+export function groupDefaults() {
+    return {
+        ChildElements: [],
+    };
+}
+export function checkBoxDefaults() {
+    return {
+        LanguageCode: "",
+        Text: "",
+        TextPosition: "right",
+        GroupName: "",
+        CheckedValue: "Y",
+        UnCheckedValue: "N",
+        Checked: false,
+        ViewType: 0,
+    };
+}
+export function comboBoxDefaults() {
+    return {
+        DataSource: "",
+        Value: "",
+        Text: "",
+        InitType: 0,
+        RefreshType: 0,
+        IsReadOnly: false,
+        SortType: 0,
+        AutoRefresh: false,
+        AfterRefresh: "",
+        UseAllItems: false,
+        UseAllItemsText: "",
+        DisplayType: 0,
+        DataSourceInfo: { LabelField: "", ValueField: "" },
+        InitValue: "",
+    };
+}
+export function textBoxDefaults() {
+    return {};
+}
+export function numberBoxDefaults() {
+    return {
+        Format: "#,##0",
+        Formula: "",
+        Value: 0,
+        Text: "",
+        IsReadOnly: false,
+        Maximum: 999999999,
+        Minimum: -999999999,
+        MxBinding: "",
+        MxBindingUseStyle: false,
+    };
+}
+export function imageDefaults() {
+    return {
+        Cursor: "default",
+        Image: { FolderCode: "", SaveName: "" },
+    };
+}
+export function richTextBoxDefaults() {
+    return {
+        Formula: "",
+        IsReadOnly: false,
+        MaxLength: 0,
+        LineSpacing: 0,
+        HasLineSpacing: false,
+        MxBinding: "",
+        MxBindingUseStyle: false,
+        Value: "",
+        Text: "",
+    };
+}
+export function userComponentDefaults() {
+    return {
+        DoRefresh: false,
+        DoExport: false,
+        ReportInfo: {},
+    };
+}
+// Type → defaults 팩토리 매핑
+export const ELEMENT_DEFAULTS_MAP = {
+    Label: labelDefaults,
+    Button: buttonDefaults,
+    DataGrid: dataGridDefaults,
+    Group: groupDefaults,
+    CheckBox: checkBoxDefaults,
+    ComboBox: comboBoxDefaults,
+    TextBox: textBoxDefaults,
+    NumberBox: numberBoxDefaults,
+    Image: imageDefaults,
+    RichTextBox: richTextBoxDefaults,
+    UserComponent: userComponentDefaults,
+};

package/dist/generators/element.d.ts

@@ -0,0 +1,31 @@
+export interface ElementInput {
+    type: string;
+    id?: string;
+    name?: string;
+    text?: string;
+    position?: {
+        left?: number;
+        top?: number;
+        width?: number;
+        height?: number;
+    };
+    docking?: string;
+    font?: {
+        size?: number;
+        bold?: boolean;
+        italic?: boolean;
+        color?: string;
+        family?: string;
+        align?: string;
+        valign?: string;
+    };
+    background?: string;
+    border?: string;
+    color?: string;
+    visible?: boolean;
+    [key: string]: any;
+}
+export declare function generateElement(input: ElementInput): {
+    element: Record<string, any>;
+    warnings: string[];
+};