@axboot-mcp/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,168 @@
+# mcp-axboot
+
+Axboot 프로젝트를 위한 MCP 서버 - Zustand Store 파일 자동 생성 및 다른 기능 확장
+
+## 기능
+
+### 현재 지원 기능
+
+1. **`analyze_interface`** - 인터페이스 Repository 파일 분석
+2. **`generate_store`** - 분석된 인터페이스 기반으로 Store 파일 생성 (타입 직접 지정)
+3. **`list_templates`** - 사용 가능한 Store 템플릿 목록 조회
+4. **`analyze_requirements`** - 자연어 요구사항 분석 및 적합한 타입 추천
+5. **`generate_store_from_requirements`** - 요구사항 기반 Store 자동 생성 (타입 자동 선택)
+
+### 요구사항 기반 자동 생성
+
+사용자가 요구사항을 자연어로 설명하면 MCP가 자동으로 가장 적합한 Store 타입을 선택하고 생성합니다:
+
+**예시:**
+- "리스트 조회하고 선택하면 상세 보이고 저장도 해줘" → Type 1 자동 선택
+- "왼쪽에 리스트, 오른쪽에 상세, 모달로 등록하고 삭제도 하고 싶어" → Type 2 자동 선택
+- "카테고리 트리 구조로 보여주고 저장할 수 있게 해줘" → Type 3 자동 선택
+
+### Store 타입 (10가지)
+
+| 타입 | 이름 | 설명 | 사용 사례 |
+|------|------|------|-----------|
+| 1 | 기본 리스트 + 상세 | 선택된 아이템의 상세 정보 표시, 저장/수정 지원 | 회원 목록, 상품 목록, 쿠폰 목록 |
+| 2 | 마스터-디테일 + 모달 + 삭제 | 왼쪽 리스트, 오른쪽 상세, 모달, 삭제 기능 (B2B 패턴) | B2B 상품, 견적 상담, 구독 관리 |
+| 3 | 트리 기반 | 트리 구조 데이터, 펼치기/접기, 저장 지원 | 카테고리 관리, 메뉴 관리, 조직도 |
+| 4 | 대시보드 | 여러 개의 리스트와 요약 정보, 탭 전환 | 회원 대시보드, 주문 대시보드, 매출 대시보드 |
+| 5 | 단순 리스트 | 최소한의 기능만 있는 단순 리스트 | 참조 데이터 조회, 드롭다운 목록 |
+| 6 | 재정렬 가능 리스트 | 드래그 앤 드롭으로 순서 변경 가능 | 팝업 메뉴, 배너 순서, 메뉴 순서 |
+| 7 | 마스터-디테일 + 모달 + 삭제 + 엑셀 | 왼쪽 리스트, 오른쪽 상세, 모달, 삭제, 엑셀 다운로드 | B2B 견적 상담, 상담 관리, 주문 관리 |
+| 8 | 리스트 + 선택 + 엑셀 다운로드 | 선택 아이템, 체크박스, 엑셀 다운로드 (상세 없음) | 주문 전체 조회, 결제 조회, 배송 조회 |
+| 9 | 마스터-디테일 + 모달 + 상세조회 API | 왼쪽 리스트, 오른쪽 상세, 모달, 상세 조회 API 호출 | 직배송 구독, 상담 내역, 주문 상세 |
+| 10 | 마스터-디테일 + 엑셀 다운로드 | 선택된 행 표시, 엑셀 다운로드 (상세/모달 없음) | 상품 그룹 마스터, 분류 관리, 카테고리 마스터 |
+
+## 설치
+
+```bash
+cd /Users/kyle/Desktop/mcp-axboot
+npm install
+```
+
+## 빌드
+
+```bash
+npm run build
+```
+
+## Claude Desktop 설정
+
+`~/Library/Application Support/Claude/claude_desktop_config.json`에 추가:
+
+```json
+{
+  "mcpServers": {
+    "mcp-axboot": {
+      "command": "node",
+      "args": ["/Users/kyle/Desktop/mcp-axboot/dist/index.js"]
+    }
+  }
+}
+```
+
+## 사용 방법
+
+### Claude 대화에서 직접 사용
+
+```
+# 타입을 지정해서 생성
+사용자: MemberRepository 분석해서 Type 2 스타일로 Store 생성해줘
+
+# 요구사항만 설명해서 자동 생성 (추천)
+사용자: MemberRepository 기반으로 리스트 조회하고 선택하면 상세 보이고 저장도 되는 Store 만들어줘
+Claude: 요구사항을 분석하니 Type 1 (기본 리스트 + 상세)이 적합합니다. Store를 생성합니다...
+```
+
+### MCP 도구 직접 호출
+
+```typescript
+// 1. 인터페이스 분석
+analyze_interface({
+  interfacePath: "/path/to/MemberRepository.ts"
+})
+
+// 2. Store 생성 (타입 직접 지정)
+generate_store({
+  interfacePath: "/path/to/MemberRepository.ts",
+  outputPath: "/path/to/useMemberStore.ts",
+  storeType: 1,
+  storeName: "useMemberStore"
+})
+
+// 3. 요구사항 분석
+analyze_requirements({
+  requirements: "리스트 조회하고 선택하면 상세 보이고 저장도 해줘"
+})
+
+// 4. 요구사항 기반 Store 생성 (타입 자동 선택) ⭐ 추천
+generate_store_from_requirements({
+  interfacePath: "/path/to/MemberRepository.ts",
+  outputPath: "/path/to/useMemberStore.ts",
+  requirements: "리스트 조회하고 선택하면 상세 보이고 저장도 해줘",
+  storeName: "useMemberStore"
+})
+
+// 5. 템플릿 목록 조회
+list_templates()
+```
+
+### 요구사항 분석 키워드
+
+| 키워드 | 해당 피처 | 예시 |
+|--------|-----------|------|
+| 리스트, 목록, 조회 | LIST | "회원 목록 조회" |
+| 검색, 찾기 | SEARCH | "이름으로 검색" |
+| 상세, 디테일 | DETAIL_PANEL | "상세 정보 표시" |
+| 모달, 팝업 | MODAL | "모달로 등록" |
+| 저장, 수정, 등록 | SAVE | "정보 저장" |
+| 삭제 | DELETE | "선택 삭제" |
+| 엑셀, excel | EXCEL_DOWNLOAD | "엑셀 다운로드" |
+| 체크, checkbox | CHECKBOX | "체크박스로 다중 선택" |
+| 트리, 카테고리 | TREE | "트리 구조" |
+
+## 프로젝트 구조
+
+```
+mcp-axboot/
+├── src/
+│   ├── index.ts                     # MCP 서버 진입점
+│   ├── handlers/
+│   │   ├── analyze.ts               # 인터페이스 분석
+│   │   ├── generate.ts              # Store 생성 (타입 직접 지정)
+│   │   ├── list-templates.ts        # 템플릿 목록
+│   │   ├── analyze-requirements.ts  # 요구사항 분석 ⭐
+│   │   └── generate-from-requirements.ts # 요구사항 기반 생성 ⭐
+│   ├── features/
+│   │   └── store-features.ts        # 피처/태그 정의 ⭐
+│   └── templates/
+│       ├── index.ts                 # 템플릿 라우터
+│       ├── type1.ts                 # Type 1 템플릿 (기본 리스트 + 상세)
+│       ├── type2.ts                 # Type 2 템플릿 (마스터-디테일 + 모달 + 삭제)
+│       ├── type3.ts                 # Type 3 템플릿 (트리 기반)
+│       ├── type4.ts                 # Type 4 템플릿 (대시보드)
+│       ├── type6.ts                 # Type 5 템플릿 (단순 리스트)
+│       ├── type7.ts                 # Type 6 템플릿 (재정렬 가능 리스트)
+│       ├── type8.ts                 # Type 7 템플릿 (마스터-디테일 + 모달 + 삭제 + 엑셀)
+│       ├── type9.ts                 # Type 8 템플릿 (리스트 + 선택 + 엑셀 다운로드)
+│       ├── type10.ts                # Type 9 템플릿 (마스터-디테일 + 모달 + 상세조회 API)
+│       └── type11.ts                # Type 10 템플릿 (마스터-디테일 + 엑셀 다운로드)
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 향후 확장 가능 기능
+
+- [ ] Component 생성
+- [ ] Interface 파일 생성
+- [ ] Service 파일 생성
+- [ ] DTO 파일 생성
+- [ ] 전체 모듈 스캐딩 (CRUD 페이지 생성)
+
+## 라이선스
+
+MIT

package/REPOSITORY_CONVENTIONS.md

@@ -0,0 +1,250 @@
+# Repository 생성 규칙 (Repository Conventions)
+
+완벽한 Store 파일 자동 생성을 위해 Repository 파일이 따라야 할 규칙입니다.
+
+## 1. 기본 구조
+
+### 1.1 클래스 이름
+
+```typescript
+// ✅ 올바른 예
+export class OrderRepository extends APIRepository implements OrderInterface { }
+export class MemberRepository extends APIRepository implements MemberInterface { }
+
+// ❌ 피해야 할 예
+export class OrderRepo extends APIRepository { }  // 'Repository' 접미사 필수
+export class OrderRepository implements OrderInterface { }  // APIRepository 상속 필수
+```
+
+**규칙:**
+- 클래스 이름은 `{엔티티명}Repository` 형식
+- `APIRepository`를 상속받아야 함
+- 해당 인터페이스를 구현해야 함
+
+### 1.2 Service 등록
+
+`src/services/index.ts`에 다음과 같이 등록해야 합니다:
+
+```typescript
+// ✅ 올바른 예
+export const OrderService = new OrderRepository(apiWrapper);
+export const MemberService = new MemberRepository(apiWrapper);
+
+// ❌ 피해야 할 예
+export const OrderSerevice = new OrderRepository(apiWrapper);  // 오타 주의
+// Service가 등록되지 않음
+```
+
+**규칙:**
+- Service 이름은 `{엔티티명}Service` 형식 (Repository → Service 변환)
+- 오타 주의 (예: `Serevice`, `Servcie` 등)
+
+## 2. 메서드 정의
+
+### 2.1 메서드 주석
+
+```typescript
+/* 배너 목록 */
+async postBannerListBanner(params: PostBannerListBannerRequest, config?: ApiRequestConfig) {
+  // ...
+}
+
+/* 배너 상세 */
+async postBannerDtlInfoBanner(params: PostBannerDtlInfoBannerRequest, config?: ApiRequestConfig) {
+  // ...
+}
+
+/* 배너 삭제 */
+async postBannerDeleteBanner(params: PostBannerDeleteBannerRequest, config?: ApiRequestConfig) {
+  // ...
+}
+```
+
+**규칙:**
+- 메서드 바로 앞에 `/* 주석 */` 형태로 주석 작성
+- 주석과 메서드 사이에 다른 코드가 있으면 안 됨
+- 주석 내용은 간결하고 명확하게
+
+### 2.2 메서드 이름 규칙
+
+```typescript
+// ✅ 올바른 예
+async postOrderListOrder(params: PostOrderListOrderRequest, config?: ApiRequestConfig)
+async postOrderDetailOrder(params: PostOrderDetailOrderRequest, config?: ApiRequestConfig)
+async postOrderSaveOrder(params: PostOrderSaveOrderRequest, config?: ApiRequestConfig)
+async postOrderDeleteOrder(params: PostOrderDeleteOrderRequest, config?: ApiRequestConfig)
+async postOrderListOrderExcel(params: PostOrderListOrderExcelRequest, config?: ApiRequestConfig)
+
+// ❌ 피해야 할 예
+async getOrderList(params: GetOrderListRequest)  // get 사용하지 않기
+async postOrderListOrderExcelDownload(params: ...)  // Excel만 사용
+```
+
+**규칙:**
+- 모든 메서드는 `post`로 시작 (API 메서드 통일)
+- 네이밍 패턴: `post{엔티티}{기능}{엔티티}`
+
+| 기능 | 접미사 | 예시 |
+|------|--------|------|
+| 목록 조회 | `List{Entity}` | `postOrderListOrder` |
+| 상세 조회 | `Detail{Entity}` | `postOrderDetailOrder` |
+| 저장/수정 | `Save{Entity}` | `postOrderSaveOrder` |
+| 삭제 | `Delete{Entity}` | `postOrderDeleteOrder` |
+| 엑셀 다운로드 | `List{Entity}Excel` | `postOrderListOrderExcel` |
+
+### 2.3 파라미터와 반환 타입
+
+```typescript
+// ✅ 올바른 예
+async postOrderListOrder(
+  params: PostOrderListOrderRequest,  // Request 타입
+  config?: ApiRequestConfig  // 선택적 설정
+) {
+  const { data } = await this._apiWrapper<PostOrderListOrderResponse>(
+    "post",
+    `/so/bo/or/order/order/v1/listOrder`,
+    params,
+    config
+  );
+  return data;
+}
+
+// ❌ 피해야 할 예
+async postOrderListOrder(params: any)  // 타입 명시 필수
+async postOrderListOrder(params: PostOrderListOrderRequest[], config?: ApiRequestConfig)  // 배열 타입은 Store 생성에 사용되지 않음
+```
+
+**규칙:**
+- 첫 번째 파라미터는 `*Request` 타입
+- 두 번째 파라미터는 `config?: ApiRequestConfig` (선택)
+- `_apiWrapper`의 제네릭은 `*Response` 타입
+- 배열 타입(`[]`)은 피할 것 (Store 자동 생성 시 제외됨)
+
+## 3. Response 구조
+
+### 3.1 표준 Response 구조
+
+```typescript
+interface PostOrderListOrderResponse {
+  ds: OrderRes[];        // 데이터 목록
+  page: {                // 페이지 정보
+    pageNumber: number;
+    pageSize: number;
+    pageCount: number;
+    totalCount?: number;
+  };
+}
+```
+
+**규칙:**
+- `ds`: 데이터 배열
+- `page`: 페이지 정보 객체
+- 이 구조를 따르면 자동 생성된 Store가 정상 작동
+
+### 3.2 단일 항목 Response
+
+```typescript
+interface PostOrderDetailOrderResponse {
+  // 단일 객체 구조
+  orderNo: string;
+  orderStatus: string;
+  // ...
+}
+```
+
+**규칙:**
+- Detail/Info 메서드는 단일 객체 반환
+- DTO 타입으로 사용됨
+
+## 4. 타입 정의
+
+### 4.1 Request/Response 타입
+
+```typescript
+// ✅ 올바른 예
+interface PostOrderListOrderRequest {
+  pageNumber: number;
+  pageSize: number;
+  orderStatus?: string;
+}
+
+interface PostOrderListOrderResponse {
+  ds: OrderRes[];
+  page: PageInfo;
+}
+
+interface OrderRes {
+  orderNo: string;
+  orderStatus: string;
+  // ...
+}
+```
+
+**규칙:**
+- Request: `Post{엔티티}{기능}{엔티티}Request` 형식
+- Response: `Post{엔티티}{기능}{엔티티}Response` 형식
+- DTO: `{엔티티}Res` 형식 (또는 Response 자체)
+
+## 5. 일반적인 주의사항
+
+### 5.1 오타 방지
+
+```typescript
+// ❌ 오타 예시
+export const BannerSerevice = new BannerRepository(apiWrapper);  // Serevice → Service
+export const MemeberService = new MemberRepository(apiWrapper);  // Memeber → Member
+```
+
+### 5.2 일관성
+
+- 한 프로젝트 내에서 일관된 네이밍 사용
+- 같은 기능은 같은 접미사 사용
+- 주석 스타일 통일
+
+### 5.3 Export 확인
+
+모든 Repository와 Service가 `src/services/index.ts`에 export되어 있는지 확인:
+
+```typescript
+export { OrderRepository } from "./@interface/repository/OrderRepository";
+export const OrderService = new OrderRepository(apiWrapper);
+```
+
+## 6. 문제 해결 가이드
+
+### 6.1 Service를 찾을 수 없음
+
+```
+error TS2304: Cannot find name 'OrderService'
+```
+
+**해결:** `src/services/index.ts`에 Service가 등록되어 있는지 확인
+
+### 6.2 pageNumber가 Request에 없음
+
+```
+error TS2353: Object literal may only specify known properties, and 'pageNumber' does not exist
+```
+
+**해결:** Request 타입에 `pageNumber`, `pageSize`가 포함되어 있는지 확인
+
+### 6.3 ds/page가 Response에 없음
+
+```
+error TS2339: Property 'ds' does not exist on type 'PostXxxResponse'
+```
+
+**해결:** Response 구조가 표준(`ds`, `page`)을 따르는지 확인
+
+## 7. 체크리스트
+
+Repository 생성 후 다음을 확인하세요:
+
+- [ ] 클래스 이름이 `{Entity}Repository` 형식인가?
+- [ ] `APIRepository`를 상속받는가?
+- [ ] 모든 메서드에 주석이 있는가?
+- [ ] 메서드 이름이 `post{Entity}{Action}{Entity}` 형식인가?
+- [ ] Request 타입에 `pageNumber`, `pageSize`가 있는가? (목록 조회의 경우)
+- [ ] Response에 `ds`, `page`가 있는가? (목록 조회의 경우)
+- [ ] `src/services/index.ts`에 Service가 등록되어 있는가?
+- [ ] Service 이름에 오타가 없는가?