@axboot-mcp/mcp-server 1.0.0

package/store-generation-error-patterns.md

@@ -0,0 +1,225 @@
+# Store 생성 MCP 오류 패턴 분석
+
+Axboot MCP를 사용하여 생성된 Store 파일들의 오류 패턴을 정리한 문서입니다.
+
+## 개요
+
+- 분석 대상: `/src/pages/resources/NH/test/*Store.ts` (271개 파일)
+- 분석 기간: 2026-01-13
+- 목적: MCP 서버 수정을 위한 오류 패턴 식별
+
+---
+
+## 오류 패턴 분석
+
+### Case 1: TypeScript 키워드를 잘못 import한 경우
+
+**오류 유형**: `error TS1003: Identifier expected.`
+
+**원인**: TypeScript의 기본 타입 키워드(`void`, `any`, `unknown`)를 "services" 모듈에서 import하려고 시도
+
+**영향받은 Store 파일**:
+- `useBizDeptListStore.ts` (line 7)
+- `useDeliveryListStore.ts` (line 5)
+- `useIndvdlztnProfileListStore.ts` (line 5)
+- `useIsmsListStore.ts` (line 8)
+- `useMemberNotificationListStore.ts` (line 5)
+- `useNaverEpListStore.ts` (line 8)
+- `useOpCnsltMainListStore.ts` (line 5)
+- `useOpCommonListStore.ts` (line 5)
+- `useOrderClmMngListStore.ts` (line 5)
+- `usePbIsmsListStore.ts` (line 5)
+- `usePbPayStupListStore.ts` (line 5)
+- `useProdRgstBnefListStore.ts` (line 8)
+- `useUsrProdRgstListStore.ts` (line 12)
+- `useUsrProfileListStore.ts` (line 12)
+- `useXoProdgrpStupListStore.ts` (line 7)
+- `useXoStdrInfoListStore.ts` (line 11)
+
+**문제 코드 예시**:
+```typescript
+import { ..., void } from "services";
+```
+
+**올바른 코드**:
+```typescript
+// void는 TypeScript 기본 타입이므로 import할 필요 없음
+import { ..., SomeType } from "services";
+```
+
+---
+
+### Case 2: TypeScript 키워드를 extends 한 경우
+
+**오류 유형**: `error TS1109: Expression expected.`
+
+**원인**: TypeScript의 기본 타입(`void`, `any`)을 interface에서 extends 하려고 시도
+
+**영향받은 Store 파일**:
+- `useBizDeptListStore.ts` (line 18)
+- `useDeliveryListStore.ts` (line 12)
+- `useIndvdlztnProfileListStore.ts` (line 12)
+- `useIsmsListStore.ts` (line 19)
+- `useMemberNotificationListStore.ts` (line 12)
+- `useOpCnsltMainListStore.ts` (line 12)
+- `useOpCommonListStore.ts` (line 12)
+- `useOrderClmMngListStore.ts` (line 12)
+- `usePbIsmsListStore.ts` (line 12)
+- `usePbPayStupListStore.ts` (line 12)
+- `useProdRgstBnefListStore.ts` (line 19)
+- `useUsrProdRgstListStore.ts` (line 22)
+- `useUsrProfileListStore.ts` (line 24)
+- `useXoProdgrpStupListStore.ts` (line 18)
+- `useXoStdrInfoListStore.ts` (line 23)
+
+**문제 코드 예시**:
+```typescript
+interface ListRequest extends void {
+}
+```
+
+**올바른 코드**:
+```typescript
+interface ListRequest {
+  // 빈 객체 또는 필요한 필드 정의
+}
+```
+
+---
+
+### Case 3: 서비스 메서드 누락
+
+**오류 유형**: `error TS1003: Identifier expected.`
+
+**원인**: 서비스 호출 시 메서드 이름이 누락되고 함수 호출 연산자만 존재
+
+**영향받은 Store 파일**:
+- `useIlSmsListStore.ts` (line 66)
+- `useMemberSnsLoginListStore.ts` (line 66)
+- `useMsghubListStore.ts` (line 66)
+- `useNaverEpPbListStore.ts` (line 66)
+- `useOnOffEstmtListStore.ts` (line 66)
+
+**문제 코드 예시**:
+```typescript
+const response = await IlSmsService.(deleteEmptyValue({
+  apiParam,
+}));
+```
+
+**올바른 코드**:
+```typescript
+const response = await IlSmsService.postIlSmsList(deleteEmptyValue({
+  apiParam,
+}));
+```
+
+---
+
+### Case 4: any/unknown 타입을 잘못 사용한 경우
+
+**오류 유형**: `error TS1003: Identifier expected.`
+
+**원인**: `any` 또는 `unknown` 타입을 "services"에서 import하려고 시도
+
+**영향받은 Store 파일**:
+- `useIlSmsListStore.ts` (line 5) - `any`, `unknown` import
+- `useMemberSnsLoginListStore.ts` (line 5) - `any`, `unknown` import
+- `useMsghubListStore.ts` (line 5) - `any`, `unknown` import
+- `useNaverEpPbListStore.ts` (line 5) - `any`, `unknown` import
+
+**문제 코드 예시**:
+```typescript
+import { IlSmsService, any, unknown } from "services";
+
+interface ListRequest extends any {
+}
+```
+
+**올바른 코드**:
+```typescript
+import { IlSmsService } from "services";
+
+interface ListRequest {
+  // 빈 객체 또는 필요한 필드 정의
+}
+```
+
+---
+
+## 오류별 Store 파일 목록
+
+| Store 파일 | 오류 라인 | 오류 타입 | 원인 |
+|-----------|----------|----------|------|
+| `useBizDeptListStore.ts` | 7, 18 | TS1003, TS1109 | void import/extends |
+| `useDeliveryListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `useIlSmsListStore.ts` | 5, 66 | TS1003 | any/unknown import, 메서드 누락 |
+| `useIndvdlztnProfileListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `useIsmsListStore.ts` | 8, 19 | TS1003, TS1109 | void import/extends |
+| `useMemberNotificationListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `useMemberSnsLoginListStore.ts` | 5, 66 | TS1003 | any/unknown import, 메서드 누락 |
+| `useMsghubListStore.ts` | 5, 66 | TS1003 | any/unknown import, 메서드 누락 |
+| `useNaverEpListStore.ts` | 8 | TS1003 | void import |
+| `useNaverEpPbListStore.ts` | 5, 66 | TS1003 | any/unknown import, 메서드 누락 |
+| `useOnOffEstmtListStore.ts` | 66 | TS1003 | 메서드 누락 |
+| `useOpCnsltMainListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `useOpCommonListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `useOrderClmMngListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `usePbIsmsListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `usePbPayStupListStore.ts` | 5, 12 | TS1003, TS1109 | void import/extends |
+| `useProdRgstBnefListStore.ts` | 8, 19 | TS1003, TS1109 | void import/extends |
+| `useUsrProdRgstListStore.ts` | 12, 22 | TS1003, TS1109 | void import/extends |
+| `useUsrProfileListStore.ts` | 12, 24 | TS1003, TS1109 | void import/extends |
+| `useXoProdgrpStupListStore.ts` | 7, 18 | TS1003, TS1109 | void import/extends |
+| `useXoStdrInfoListStore.ts` | 11, 23 | TS1003, TS1109 | void import/extends |
+
+---
+
+## MCP 서버 수정 권장사항
+
+### 1. TypeScript 타입 처리 로직 수정
+
+**문제**: Repository 분석 시 TypeScript 기본 타입(`void`, `any`, `unknown`)을 별도 import로 처리
+
+**해결 방안**:
+- TypeScript 기본 타입 키워드 목록을 정의하고 필터링
+- `void`, `any`, `unknown`, `never`, `null`, `undefined`, `boolean`, `number`, `string`, `object`, `symbol`, `bigint` 등은 import에서 제외
+
+### 2. 빈 Request 타입 처리
+
+**문제**: API의 Request 타입이 없을 때 `void`를 extends 하려고 시도
+
+**해결 방안**:
+- Request 타입이 없는 경우 빈 interface로 정의
+```typescript
+interface ListRequest {
+  // 필요한 경우 빈 상태로 유지
+}
+```
+
+### 3. 서비스 메서드 이름 추출 로직 개선
+
+**문제**: Repository 메서드 이름을 올바르게 추출하지 못하는 경우 발생
+
+**해결 방안**:
+- Repository 분석 시 메서드 이름 추출 로직 검증
+- 빈 메서드 이름이나 잘못된 파싱 결과를 필터링
+
+### 4. Interface Repository 파싱 개선
+
+**검토 필요 항목**:
+- JSDoc 주석에서 타입 정보 추출 정확도
+- 제네릭 타입 파싱 처리
+- 복잡한 타입 상속 구조 처리
+
+---
+
+## 정리
+
+총 **30개 Store 파일**에서 오류가 발견되었으며, 주요 패턴은:
+
+1. **TypeScript 키워드 잘못 import (Case 1, 4)**: 21개 파일
+2. **TypeScript 키워드 잘못 extends (Case 2)**: 18개 파일
+3. **서비스 메서드 누락 (Case 3)**: 5개 파일
+
+이러한 오류 패턴을 수정하면 MCP 서버가 정상적인 Store 코드를 생성할 수 있습니다.

package/test/useAgentStore.ts

@@ -0,0 +1,136 @@
+import { AXDGDataItem, AXDGSortParam } from "@axboot/datagrid";
+import { StoreActions } from "@core/stores/types";
+import { deleteEmptyValue } from "@core/utils/object";
+import { ProgramFn } from "@types";
+
+import { getTabStoreListener } from "stores";
+import { create } from "zustand";
+import { subscribeWithSelector } from "zustand/middleware";
+import { shallow } from "zustand/shallow";
+
+interface ListRequest {}
+
+interface DtoItem extends  {}
+
+// ========== interface MetaData ==========
+interface MetaData {
+  programFn?: ProgramFn;
+  
+  listColWidths: number[];
+  listSortParams: AXDGSortParam[];
+  
+}
+
+// ========== interface States ==========
+interface States extends MetaData {
+  routePath?: string;
+  listSpinning: boolean;
+  
+  
+  
+  listData: AXDGDataItem<DtoItem>[];
+  
+
+  // 마스터-디테일 (오른쪽 상세)
+  selectedItem?: DtoItem;
+  detail?: DtoItem;
+  detailSpinning: boolean;
+}
+
+// ========== const createState ==========
+const createState: States = {
+  listColWidths: [],
+  listSortParams: [],
+  listSpinning: false,
+  
+  
+  
+  listData: [],
+  
+
+  selectedItem: undefined,
+  detail: undefined,
+  detailSpinning: false,
+};
+
+// ========== interface Actions ==========
+interface Actions extends Record<string, any> {
+  setListColWidths: (colWidths: number[]) => void;
+  setListSpinning: (spinning: boolean) => void;
+  callListApi: (request?: ListRequest) => Promise<void>;
+  
+  
+  
+  
+  setSelectedItem: (selectedItem?: DtoItem) => void;
+  setDetail: (detail?: DtoItem) => void;
+  
+}
+
+// ========== const createActions ==========
+const createActions: StoreActions<States & Actions, Actions> = (set, get) => ({
+  
+
+  setListColWidths: (colWidths) => set({ listColWidths: colWidths }),
+
+  setListSpinning: (spinning) => set({ listSpinning: spinning }),
+
+  
+  callListApi: async (request) => {
+    if (get().listSpinning) return;
+    set({ listSpinning: true });
+
+    try {
+      
+      const response = await .();
+
+      set({
+        
+        
+        listData: [],
+        
+      });
+    } finally {
+      set({ listSpinning: false });
+    }
+  },
+
+
+  setSelectedItem: (selectedItem) => {
+    set({ selectedItem, detailSpinning: true });
+    set({ detailSpinning: false });
+  },
+
+  setDetail: (detail) => {
+    set({ detail });
+  },
+
+  
+
+  
+
+  
+
+  
+});
+
+// ========== export ==========
+export interface  extends States, Actions {}
+
+export const  = create(
+  subscribeWithSelector<>((set, get) => ({
+    ...createState,
+    ...createActions(set, get),
+  })),
+);
+
+// ========== Store.subscribe ==========
+.subscribe(
+  (s): Record<keyof MetaData, any> => ({
+    programFn: s.programFn,
+    listColWidths: s.listColWidths,
+    listSortParams: s.listSortParams,
+  }),
+  getTabStoreListener<MetaData>(createState.routePath),
+  { equalityFn: shallow },
+);

package/test-server.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+// MCP 서버 테스트 스크립트
+import { spawn } from 'child_process';
+
+const serverProcess = spawn('node', ['/Users/kyle/work/mcp-axboot/dist/index.js'], {
+  stdio: ['pipe', 'pipe', 'inherit']
+});
+
+let messageId = 0;
+
+function sendRequest(method, params = {}) {
+  const request = {
+    jsonrpc: '2.0',
+    id: messageId++,
+    method,
+    params
+  };
+
+  console.log('\n→ Sending:', JSON.stringify(request, null, 2));
+  serverProcess.stdin.write(JSON.stringify(request) + '\n');
+}
+
+// 서버 시작 대기
+setTimeout(() => {
+  console.log('서버가 시작되었습니다. 요청을 보냅니다...\n');
+
+  // 1. tools/list 요청 - 사용 가능한 도구 목록 조회
+  sendRequest('tools/list');
+
+}, 1000);
+
+// 응답 수신
+serverProcess.stdout.on('data', (data) => {
+  const responses = data.toString().trim().split('\n');
+
+  for (const responseStr of responses) {
+    if (!responseStr.trim()) continue;
+
+    try {
+      const response = JSON.parse(responseStr);
+      console.log('\n← Received:', JSON.stringify(response, null, 2));
+
+      // tools/list 응답을 받은 후 tools/call 요청
+      if (response.result && response.result.tools) {
+        console.log('\n=== 사용 가능한 도구 목록 ===');
+        response.result.tools.forEach(tool => {
+          console.log(`- ${tool.name}: ${tool.description}`);
+        });
+
+        // 첫 번째 도구 호출 테스트 (list_templates)
+        setTimeout(() => {
+          console.log('\n\nlist_templates 도구 호출 테스트...');
+          sendRequest('tools/call', {
+            name: 'list_templates',
+            arguments: {}
+          });
+        }, 500);
+      }
+    } catch (e) {
+      console.log('\n← Raw:', responseStr);
+    }
+  }
+});
+
+serverProcess.on('error', (error) => {
+  console.error('서버 오류:', error);
+});
+
+serverProcess.on('exit', (code) => {
+  console.log(`\n서버가 종료되었습니다 (exit code: ${code})`);
+});
+
+// 10초 후 종료
+setTimeout(() => {
+  serverProcess.kill();
+  process.exit(0);
+}, 10000);

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}